- Reference Manual 


OMPUTER’ 
¡SSOCIATES 


Software superior by design. 


00-75-041-35005 


SUPERCALC 


bo f A 
fj 


nl e - Manual 


ES 


j q 


OMPUTER’ 
¡SSOCIATES 


Software superior by design. 


Third Edition 
April 1989 


Manual ©1989 
Computer Associates International, Inc. 


All Rights Reserved 


Computer Associates International, Inc., 
Publisher 


United States 

1240 McKay Drive 

San Jose, CA 95131 
Telephone (408) 432-1727 
FAX (408) 432-0614 

Telex 910 338 2003 
Canada 

3rd Floor 

1770 Burrard Street 
Vancouver, B.C. V6J 3G7 
Telephone (604) 733-2343 
Telex 04-508357 


United Kingdom 
Computer Associates House 
183-187 Bath Road 

Slough Berkshire SL1 4AA 
Telephone (0753) 77733 
Telex 847268 


Australia 

8th Floor 

55 Lavender Street 
Milsons Point, NSW 2061 
Telephone (02) 923 2066 
Telex AA121540 GESI 


Lotus and 1-2-3 are registered trademarks of Lotus Development Corporation. 
dBase III and dBase III are registered trademarks of Ashton-Tate. 

SIDEWAYS is a registered trademark of Funk Software, Inc. 

DIF is a trademark of Software Arts, Inc. 

VisiCalc is a registered trademark of Lotus Development Corporation. 
Hercules is a registered trademark of Hercules Computer Technology. 
COMPAQ is a registered trademark of Compaq Technology. 

IBM is a registered trademark of International Business Machines Corporation. 


Preface 


The “Other” Preface 


If you haven't already done so, take a few moments now to read 
the User’s Guide Preface, which introduces SuperCalc and some of 
its powerful features. It also lists various hardware and DOS 
requirements, describes Computer Associates’ product support 
services, and explains how to use the README.prn file. 


About this Manual... 


The Reference Manual emphasizes advanced topics and provides 
in-depth explanations of all SuperCalc command options and 
program features. (In contrast, the User's Guide emphasizes basic 
instructions and is most helpful when you are first learning 
SuperCalc.) 


The Reference Manual is organized as follows: 


m Chapter 1 details SuperCalc program features and their 
operation. 


m Chapter 2 defines and cross references SuperCalc slash 
commands and their options. 


E Chapter 3 lists SuperCalc functions alphabetically with 
complete descriptions and syntax. 


m Chapter 4 covers macro syntax and macro command 
definitions. 


m Chapter 5 explains how to use SuperCalc on networks for end 
users and for network administrators. 
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About this Manual... 


The Appendixes include: 


Error and advisory messages. 


Procedures for using AUDIT mode and the SIDEWAYS utility 
programs. ae 


Comparisons with previous versions of SuperCalc, and with 
Lotus 1-2-3 Release 2. 


Sample graphics font output and DIP switch settings for 
graphics printing devices. 


Descriptions of advanced SuperCalc applications. 


ASCII code table. 


The Reference Manual Index covers the contents of this manual 
only. 
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Chapter 1 
Feature Details 


What’s in this Chapter? 

This chapter provides detailed information on SuperCalc features 
that operate throughout the program, and are not limited to a 
single command or function. Topics include: 

m SuperCalc Modes 

E Command Keys 

m File Retrieval 

m Invoking or Loading Files during Startup 

m Setup Strings 

m Optimizing SuperCalc Performance 

m Hardware Considerations 

Formula operands and operators, reference syntax and cell 


references, and formula adjustment are general topics discussed in 
Chapter 3. 


SuperCalc Modes 


SuperCalc has three basic mode types: program, macro, and 
keyboard. Within each type, there are several different modes. 
Mode indicators appear on the help line at the bottom of the 
screen to show which mode(s) are active. This section describes 
the modes and the main operations you can perform within them. 
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SuperCalc Modes 


Program Modes 


SuperCalc has these program modes: AUDIT, EDIT, ENTRY, FILE, 
INPUT, MENU, NAME, POINT, READY, SHEET, and WRAP. The 
program mode indicators display at the left end of the help line as 
you move from one program operation to another. For example, 
when you start SuperCalc, the program is ready to respond to 
your first action. READY displays at the beginning of the help 
line. 


Mode Meaning 


AUDIT You have selected //Test or pressed Alt—F1 to 
activate SuperCalc’s spreadsheet auditing 
features. Type a single slash (/) to activate 
the AUDIT mode command menu, then select 
from these options: Highlight, Names, 
keplace, Squeeze, View, Details, and Quit. 
They let you locate selected types of data, 
find and replace formulas and text, optimize 
memory usage, and detect possible sources of 
error. Appendix B contains a complete 
description of AUDIT mode and its uses. 


EDIT You pressed F2 to toggle from ENTRY or 
POINT mode to EDIT mode, or the program 
turned EDIT mode on automatically from 
POINT or FILE mode. You can use the cursor 
movement keys to move the edit cursor. 


ENTRY You entered data: formula, text, repeating 
text, or control text. To change an entry, press 
F2 for EDIT mode. Terminate an entry by 
pressing an Arrow key or Return. Data is 
sent to the current cell, and the cell cursor 
moves to the next cell. 
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FILE 


INPUT 


MENU 


NAME 


SuperCalc Modes 


FILE mode occurs automatically when 
filename entry is required (/Load, /Save, and 
so on). The default filename appears on the 
entry line. If the file was loaded from a 
directory other than the default, its name 
displays in fully-qualified form, with drive and 
directory. Press F4 to display only the short, 
unqualified filename if you want to save the 
file to or load from the default directory. 


You can change the filename by typing a new 
one. You don’t need to delete the unwanted 
filename; just start typing. Typing changes 
the mode to EDIT. To change only part of 
the existing name, press F2 for EDIT mode, 
then use the Arrow keys to move to the part 
you want to change. 


The Restrict command is in control. You can 
enter data within the restricted range. 


You pressed the slash key (/) to select a 
command, or a macro menu is being 
displayed. Arrow, Spacebar, End, and 
Home move the menu cursor. 


MENU mode remains until you complete your 
command entry, or until a range or filename 
entry is required (automatically changing 
MENU mode to POINT or FILE mode). 


You pressed F3 for the Named Range 
Directory. 
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SuperCalc Modes 


POINT 


READY 


SHEET 


POINT mode occurs automatically, when a 
range entry is required. When you enter a 
formula requiring a range entry, press Arrow 
or F4 to turn on POINT mode. You can use 
the cursor control keys to point to a cell and 
return its address to the entry line. The form 
of a range entry is: first address:last 
address. You can use a period (.) instead of 
a colon (:), for example: A1:A15 or A1.A15. 


To change the first address in a range, move 
the cell cursor, or type a new address. There 
is no need to delete the unwanted first 
address or move the edit cursor before typing; 
the program does that for you. Typing 
changes the mode to EDIT. 


Optionally, you can press F2 for EDIT mode, 
and delete or alter the cell address manually. 


If POINT mode is active when you press a 
range delimiter (period or colon), the current 
cell address appears on the entry line as the 
last address in the range. To change the last 
address, you can move the cell cursor (point), 
press F2 for EDIT mode, or just type in the 
ending cell. 


The program is waiting for data entry or a 
command. Cursor movement keys move the 
cell cursor. 


You pressed Ctri-F4 to display the Open 
Spreadsheet Directory. Use the Arrow keys 
to select a Sheetname!page. To select a 
page range, press period (.) or colon (:) to 
anchor the range, then move the cursor to the 
end of the range and press Return. 
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SuperCalc Mode 


WRAP You selected Justify, Word-wrap. While in 
WRAP mode, any text you type will be 
entered as a single column of the width you 
specify. To leave WRAP mode, move outside 
the specified range with Right or Left Arrow, 
or press Return when the entry line is empty. 
For details, see /Justify in Chapter 2. 


Macro Modes 


A macro is a set of sequential instructions, much like a set of 
programming instructions, which automatically controls the 
operations and screen displays of SuperCalc. In addition to 
indicating the program modes, SuperCalc displays macro mode 
indicators and prompts: MACRO, STEP, ASTEP, DIRECT, F8 TO 
RESUME, RETURN TO RESUME, and (F8)STEP L:# LINE #/Cell 
CONTENTS. Except for (F8)STEP... , which displays on the left, 
these display on the right half of the help line when you are 
building or running a macro. For more information on macros, 
see Chapter 4. 


Macro Mode Indicators 


Mode Meaning 
MACRO A macro is executing. 
STEP Macro Single-step mode is on. 
ASTEP Single-stepping is occurring automatically 


(Autostep mode). 


LEARN Macro Learn mode is on; each keystroke is 
being stored in the learn range. 


DIRECT Macro Direct mode is on; you can enter 


macro commands directly during a learn 
session. 
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Macro Prompts 


Mode Meaning 
F8 TO Press F8 to terminate keyboard input and 
RESUME resume macro execution. = 
RETURN TO Press Return to terminate keyboard input and 
RESUME resume macro execution. 
(F8)STEP L:# Press F8 to single-step, where L:# is the level 
LINE#/Cell number in a sequence of nested macros (the 
CONTENTS original macro = level 1) followed by the 


macro name or label of the macro currently 
called, line number or cell currently 
executing, and contents of the command 
sequence presently executing. 


Keyboard Modes 


You activate keyboard modes by pressing the keys associated 
with them: Caps Lock, Num Lock, Scroll Lock, Tab/Backtab 
(or Shift-Tab), End. When you press one of these keys, a 
keyboard mode indicator appears on the right half of the help 
line: CAPS, NUM, SCROLL, TAB, BTAB, or END. 


Mode Meaning 
CAPS Types letters in uppercase only. When CAPS 
is on, pressing Shift produces lowercase 
letters. 
NUM Enables/disables numeric keypad at the right 


end of the keyboard. When NUM is on, the 

cursor control, insert, and delete functions of 
the numeric keys are turned off, but you can 
press Shift to use these functions. 


SCROLL Locks the cell cursor in place; use the Arrow 
keys to scroll the spreadsheet. The cell cursor 
is displaced when scrolling moves the locked 
cell beyond the edge of the window display. 
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TAB, BTAB Combines with the Arrow keys to move the 
cursor to the first (Tab) or last (Backtab) 
occupied cell in a series of occupied cells, or 
to the edge of the spreadsheet. (A cell is not 
considered occupied if it contains a hidden 
value. This keyboard mode does not appear 
in EDIT mode. 


END End—Home moves the cursor to the bottom- 
right cell of the active spreadsheet. 
End—Arrow moves the cursor to the last 
occupied cell, or to the edge of the active 
spreadsheet. (A cell is not considered 
occupied if it contains a hidden value). This 
keyboard mode does not appear in EDIT 
mode. 


Command Keys 


SuperCalc makes full use of your keyboard for entering data and 
program commands. Use Ctrl, Alt, and Shift plus the function 
keys (F1 - F10) to change modes and perform operations within 
modes. With Num Lock off, you can use the numeric keypad 
keys for cursor movement. Tab, Backtab, Backspace, Return, 
and Spacebar also have special uses in certain modes, or when 
combined with other keys. The lists below summarize the effects 
of the command keys in each mode. Learn to use them as the 
need arises; you'll appreciate the time and effort they can save. 


Function Keys 


SuperCalc uses the function keys F1 through F10 (PF1 through 
PF10 on some keyboards). Each function key performs a 
different operation, either by itself or used with Ctrl, Alt, or Shift. 
For example, you press Alt and F8 at the same time to enter 
Alt-F8. 


Here is a list of the function keys and what they do within each 
SuperCalc mode: 
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Fl 


F2 


F3 


F4 


All modes: Help — displays context-sensitive 
help for commands, options, functions, and 
error messages. 


ENTRY, FILE, POINT, READY modes: Edit 
— activates EDIT mode, so you can change a ee 
data or command entry. 


In READY mode, F2 brings the contents of 
the current cell to the entry line. 


AUDIT, EDIT, ENTRY, INPUT, POINT, 
READY modes: Name — displays the 
Named Range Directory. 


FILE mode: displays the File List. 


AUDIT, EDIT, ENTRY, POINT, READY 
modes: Absolute — rotates a cell reference 
from relative (default) to absolute while you 
enter a cell address by pointing, or when 
entering or editing a formula: Al, then $A$1, 
then A$1, then $A1. Range names change 
from NAME to $NAME. If not in POINT 
mode, turns on POINT mode when a cell 
reference is valid in a formula entry. 


From a /Grapbics menu, F4 displays the 
spreadsheet for data range pointing. 


At the File List, F4 updates the data directory 
to match the current file specification. 


FILE mode: During file output or “write” 
operations such as /Save, F4 toggles between 
the short filename (file plus extension) and 
the long, fully-qualified filename including the 
drive and directory. 


NAME mode: Selects the highlighted named 
range and brings its cell references down to 
the entry line. 
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F5 


F6 


F7 


F8 


Command Key 


AUDIT, READY modes: Goto (or use =) — 
moves to the cell specified, or the upper-left 
cell of the specified range. When you press 
F5, you see => (current cell address) on the 
entry line. Enter a cell address or named 
range, then press Return. You can bring a 
range name to the entry line from the Named 
Range Directory (using F3 and Return), 
rather than typing the name. If the specified 
cell is not in the current window, it becomes 
the upper-left cell. Pressing F5 then Return 
(no cell specified) puts the current cell in the 
upper-left corner of the current window. 


At the File List, F5 clears the default data 
directory and will then search the current 
directory for files. 


In //Grapbics, F5 toggles the data range 
between Row-wise and Column-wise. 


AUDIT, READY modes: Window (switch) — 
moves the cursor between windows on a split 
screen (set with /Windows). 


When the File List displays, F6 toggles 
between standard view and details, including 
the contents of cell A1. 


In //Graphics, F6 copies attributes or returns 
defaults across fields to the right. 


AUDIT, ENTRY, POINT, READY modes: 
Labels — toggles between showing range 
definitions (for example, A6:D9) and range 
names on the entry line. Use /Global,Labels 
to show range names or range definitions in 
the spreadsheet. 


STEP mode: Executes each macro command 
in sequence. 
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F9 


F10 


Alt-F1 


Alt—F2 


Alt-F3 


Alt-F4 


Alt-F5 


Calc — recalculates the spreadsheet. 
Required for recalculation if you turn on 
/Global, Evaluation, When,Manual mode. 


Quick calculator function: F9 also shows the 
result of a formula before sending it to a cell. 
For example, if you type 568+387 then press 
F9, the result, 955, replaces the formula on 
the entry line. To restore the formula, press 
CtrL-C, then Esc. This lets you use the entry 
line for quick calculations of any kind. 


AUDIT, MENU, READY modes: View — lets 
you view the current chart on-screen. 


AUDIT mode: Toggles filter options. 


READY mode: Activates AUDIT mode (you 
can also use /Test). 


AUDIT, EDIT, ENTRY, MENU, READY 
modes: Toggles STEP mode — single-step 
operation for macro execution. In STEP 
mode, Alt-F8 toggles between STEP and 
ASTEP modes for manual or automatic control 
of step-by-step command execution. 


AUDIT, EDIT, ENTRY, POINT, READY 
modes: Displays the Macro Name/Range 
Directory, a list of spreadsheet macros for 
each spreadsheet. You can use a bar cursor 
for macro selection; press Return to execute 
the highlighted macro. 


AUDIT, EDIT, ENTRY, FILE, MENU, POINT, 
READY modes: Toggles macro LEARN mode 
on and off. 


AUDIT, READY modes: Executes the 
spreadsheet macro specified; or use 
Alt—Equal (=). 
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Alt—F6 


Alt-F8 


Alt-F9 


Alt—F10 


Alt-x 


Alt-Spacebar 


Shift—F1 
through 
Shift—F10 


Ctr-F3 


Command Keys 


LEARN mode: Toggles macro DIRECT mode 
on and off for entry of macro program 
commands. 


AUDIT, EDIT, ENTRY, POINT, READY 
modes: Restores last buffered data (cleared 
with Esc) or formula (cleared with F9) to the 
entry line; appends restored data to existing 
data on the entry line. 


STEP, ASTEP modes: Toggles between these 
two macro modes. 


AUDIT, READY modes: Recalculates last 
“what-if” table created with //Data, Table. 


AUDIT, MENU, READY modes: Plot — plots 
the current chart on the selected plotter or 
graphics printer. 


AUDIT, EDIT, ENTRY, FILE, MENU, POINT, 
READY modes: Executes a current 
spreadsheet macro named \x or a file named 
X.xqt, where x is any letter, ato z. 


STEP, ASTEP modes: Toggles help and 
advisory messages on the help line with 
//Macro, Trace, Console activated. 


AUDIT, READY modes: Invokes assigned 
add-in program for use with SuperCalc. 


AUDIT, EDIT, ENTRY, POINT, READY 
modes: Displays the Referenced Spreadsheet 
Directory of all spreadsheets linked to the 
current spreadsheet along with a notation of 
whether they are in memory or on disk. 
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Ctri-F4 AUDIT, EDIT, ENTRY, POINT, READY 
modes: Displays the Open Spreadsheet 
Directory for selecting spreadsheet pages and 
page ranges; hidden spreadsheets are marked 
with an asterisk (*) in the H column. 


Activates SHEET mode. Use the Arrow keys 
to select a page range, press period (.) or 
colon (:) to anchor the range, then move the 
cursor to the end of the range and press 
Return. 


Ctri-ES AUDIT, READY modes: Moves to the 
specified spreadsheet, spreadsheet!page, or 
page (also Ctri-Equal). For other paging 
keys, see Cursor Movement Keys later in this 
chapter. 


Ctri-F6 AUDIT, READY modes: With 
//Spreadsheets, Display activated, moves 
between open spreadsheet windows. 


Ctri-F7 AUDIT, READY modes: With 
//Spreadsheets, Display activated, toggles full- 
screen display of current spreadsheet and 
multiple spreadsheet display. 


CtrHMinus AUDIT, READY modes: Displays the 
(-) previous spreadsheet or page (according to 
entries in the Open Spreadsheet Directory). 


ENTRY mode: Activates POINT mode; 
displays the previous spreadsheet for range 


pointing. 


POINT mode: Displays the previous 
spreadsheet for range pointing. 
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CtrLPlus (+) AUDIT, READY modes: Displays the next 
spreadsheet or page (according to entries in 
the Open Spreadsheet Directory). 


ENTRY mode: Activates POINT mode; 
displays the next spreadsheet for range 
pointing. 


POINT mode: Displays the next spreadsheet 
for range pointing. 


Ctrl Undo — Cancels the last menu selection or 
Backspace data entry. 

Ctr-Break Halts the current command. 

Ctrl Return AUDIT, READY modes: Opens a new blank 


spreadsheet (also //Spreadsheets, New). 


Del MENU mode: Clears a //Graphics field and 
restores the Keep value. 


Esc MENU mode: Cancels the latest entry on the 
entry line. 
Return AUDIT, ENTRY, MENU, READY modes: 


Using //Graphics, displays a Select window 
with field entry options for the field under the 
cursor. Press Return again to select. 


NAME mode: Displays the selected range 
name on the entry line. 


Cursor Movement Keys 


Cell cursor keys move the cursor around a spreadsheet, from one 
spreadsheet to another, and from page to page within a multipage 
spreadsheet. Edit cursor keys move along the entry line in EDIT 
mode to alter and delete its contents. The menu cursor keys 
work in MENU mode to highlight and activate menu selections. 
The following lists describe the cursor movement keys, including 
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Command Keys 


Arrow Key Substitutes for use when you’re entering numbers in 
NUM LOCK mode. 


Cell Cursor Keys 


With keys that move you to the first or last occupied cell, keep in 
mind that cells containing hidden values are not considered 


occupied. 
Key Effect 

Arrows Up, down, right, or left one cell. 

Arrow Key CtrLE, up; CtrEX, down; CtrLD, right; 

Substitutes CtrLS, left. 

Home To cell Al. 

End—Home To bottom-right cell of active spreadsheet. 

End—Arrow To last occupied cell, or to edge of active 
spreadsheet. 

Tab-Arrow To first occupied cell in a series of occupied 
cells, or to edge of matrix. 

Backtab— To last occupied cell in a series of occupied 

Arrow cells, or to edge of matrix. 

Return To next cell in direction of last move (when 
/Global, Next command toggle is on). 

PgUp To same relative position, up one window, 
until it reaches row 1 or a title lock. 

PgDn To same relative position, down one window, 
until it reaches last row. 

Ctrl- To same relative position, left one window, 

Left Arrow until it reaches column A of current matrix (a 


variable column width may change the 
relative position). 
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Ctrl- 

Right Arrow 
Ctr+Home 
Ctr-End 

F5 or = 

F6 or ; 
CtriZF6 or 
Ctrl; 


CtriPPlus (+) 


CtriHMinus 
(-) 


Ctrl-Equal 
(=) 
Tab-CtrL 


Home 


Tab-CtrL 
End 


End-—Ctri- 
Home 


End-—CtrL 
End 


Tab-—CtrL 
Plus 


Tab-—CtrL 
Minus 


To same relative position, right one window, 
until it reaches last column (a variable column 
width may change the relative position). 


To top-left corner of current window. 
To bottom-right corner of current window. 
To cell specified (the Goto command). 


To other window of split screen (the Window 
switch command). 


To other spreadsheet display window (with 
//Spreadsheets, Display activated). 


To next spreadsheet or page, with multiple 
spreadsheets in memory. 


To previous spreadsheet or page, with 
multiple spreadsheets in memory. 


To specified spreadsheet or page, with 
multiple spreadsheets in memory. 


To first page of the first spreadsheet in the 
Open Spreadsheet Directory. 


To first page of the last spreadsheet in the 
Open Spreadsheet Directory. 


To first page of the current spreadsheet. 


To last page of the current spreadsheet. 


To first page of next spreadsheet in the Open 
Spreadsheet Directory. 


To first page of previous spreadsheet in the 
Open Spreadsheet Directory. 
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Edit Cursor 


The edit cursor marks the current position on the entry line. You 
can move the edit cursor in EDIT mode with these keys: 


Key Effect 
Right Arrow Right one character. 
Left Arrow Left one character. 
Home To beginning of entry line (also in ENTRY 
mode). 
End To end of entry line (also in ENTRY mode). 
Tab Between start and end of entry line (also in 


ENTRY mode). 
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Menu Cursor 


The menu cursor highlights the current menu selection on the 
dialog panel, and in various lists of options that appear in the 
window. In general, you can move the menu cursor in MENU 
mode with these keys: 


Key Effect 
Arrows Right, left, up, or down. 
Home To first item on menu. 
End To last item on menu. 
Tab To next set of options on full-screen menus. 


Correction Keys 


These keys let you insert and delete data in EDIT and ENTRY 
mode, and cancel program operations: 


Editing Keys 
Key Effect 

Ins Turns on INSERT mode. Lets you insert data 
at the edit cursor. Note that the edit cursor 
changes from underline form to block form 
when INSERT mode is on. Ins is an on/off 
toggle key. 

Up Arrow Inserts a blank space at the edit cursor (EDIT 
mode only). 

Backspace Backs up and deletes one character at a time 
in range and filename entries. 

Del Deletes the character at the edit cursor. 

Down Arrow Deletes the character at the edit cursor (EDIT 


mode only). 
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Ctrl-C Clears the entry line (or use Ctrl-Z). 


Ctr Break Clears the entry line, but also cancels macro 
execution (unless the macro uses {RBREAKOFF} 
or {ONBREAK} commands). 


Esc Clears data from the entry line. 


SuperCalc remembers your cleared data in 
case you delete it by mistake and want to 
undo the deletion. If you immediately press 
Esc again (or if you remain in READY mode, 
then press Esc), the last cleared data is 
returned to the entry line. 


Alt—F8 In AUDIT, EDIT, ENTRY, POINT, and READY 
mode, returns the data last cleared by Esc and 
appends it to data on the entry line, if any. 
The last cleared data is not lost when it is 
returned to the entry line; Alt—F8 can return 
multiple copies of the last cleared data. 


Cancellation Keys 
Key Effect 


Backspace Cancels the last entry in a command path, or 
backs up and deletes one character at a time 
in range and filename entries. 


Ctrl Cancels the last command executed, except in 
Backspace MACRO mode. 

Esc Cancels the last entry in a command path. 
Ctrl-C Clears the entry line (or use Ctrl-Z). 
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Ctr Break Clears the entry line. 


Cancels program operations such as iteration 
or plotting. 


Cancels macro execution (unless {BREAKOFF} 
is in effect or a break handler has been 
specified with {ONBREAK}). 


File Retrieval 


SuperCalc searches for the appropriate file when you give an 
incomplete or ambiguous filename while using one of these input 
commands: Load, Import, eXecute, Alt-x, and certain macro 
commands. It searches several locations in this order: default 
data directory, spreadsheet datapath, if present (see Datapaths, 
later in this chapter), and then the global datapath. 


If you don’t specify a file extension, SuperCalc looks for and loads 
files in this order: .cal, .wk1 (Lotus 1-2-3 Release 2), and .wks 
(Lotus 1-2-3 Release 1A). 


SuperCalc offers several features to help you load and import 
spreadsheet files: 

Mm File List 

m  //File,Listand //File, Directory commands 

m Datapaths 


These features extend SuperCalc’s automatic file searching 
capability and simplify file loading and importing. 


File List 


If you are loading or importing a file, you can type the filename, 
or select it from the File List. The File List displays whenever you 
press F3 in FILE mode. It also displays automatically if you 
request a file that cannot be found, or if the filename, drive, or 
directory is ambiguous. 
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File List Directories 


At the top, the File List shows the directory displayed and the 
default data directory: 


FILE LIST 
Directory displayed is C:\CALC 
Data directory is C:>CALC 


[».caL | 


| EASTSALE.cal MIDSALE .cal SALESUM .cal SOUTSALE.cal 
WESTSALE.cal ZVOLOUT .cal 


Select <DIRECTORIES? to list subdirectories 323584 bytes free 
7>/Load, 
FILE F2:Edit F4:Update or F5:Clear data directory F6:Toggle details 


When you first start SuperCalc, both directories are the same — 
the current directory when you gave the startup command. 


File Specification 


Below the directories is a box containing the current file 
specification. The default is *,CAL, or all .cal files in the current 
directory. The file specification determines the location and 
extension of files displaying on the File List. 


Selecting Files and Directories 


The first entry in the File List is enclosed in pointed brackets. 

When you first display the File List, that entry reads 

<DIRECTORIES>. You can move the cursor to one of the listed 

files for selection, or you can select <DIRECTORIES> to display a — 
list of subdirectories and .., which moves to the next higher 

directory level. 
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When you display the directory list, the first entry changes to 
<FILES>, select it to list available files again. If you select one of 
the listed directories, SuperCalc will display all files in that 
directory that match the current file specification. That directory 
will appear at the top of the screen following Directory displayed 
is. 


Changing and Keeping the Data Directory 


You can press F4 to make that directory your default data 
directory, the first place searched for files to load. Then, its name 
will display following Data directory is. To keep that directory as 
your permanent data directory, use /Global,Keep, Yes or To. The 
next time you load SuperCalc the new directory will be listed as 
the data directory. 


Clearing the Data Directory 


Once you have pressed F4 to temporarily change the data 
directory entry, you can press F5 to clear the entry and display 
the directory that was current when you started SuperCalc. 


Viewing File Details 


If you press F6 while viewing the File List, file details display for 
each file. These are the contents of cell A1 and a list of all charts 
defined for that file. To return the standard list, press F6 again; it 
acts as a toggle to turn details on and off. 


Changing the File Specification 


If you want to display files with a different extension or in a 
different directory, you can change the file specification. To 
select a different extension, use DOS wildcard conventions to 
indicate the new name. For example, you can enter *.wk1 to 
view a list of Lotus 1-2-3 Release 2 files in the default data 
directory. Just start typing the new file specification. The cursor 
moves to the file specification box to register your entry. When 
you've typed it, press Return to display the new file list. To 
change to a different directory, enter its path and the desired file 
extension. The File List changes to the new directory and its files. 
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If you don’t want to retype the entire file specification, press F2 to 
enter the file specification box in EDIT mode. 


//File,List Command 


This command offers an alternative way to list files with a certain 
extension in the default data directory. When you select 

//File, List, these options display, listed with the equivalent file 
extension in parentheses: SuperCalc (.cal), 1-2-3 (.wks and 
.Wk1), Print (prn), Macro (.xqt), Config (.cfg), and All. 


//File,Directory Command 


This command offers a way to change the default data directory 
without viewing the File List. Select //File,Directory and enter the 
new drive/directory path. Now, SuperCalc will search the new 
directory first when looking for files. 


Datapaths 


//File,Path lets you enter spreadsheet and global data directory 
paths (datapaths) to guide automatic file searching. Both 
datapaths have the same format as those set with DOS PATH=: 
they are a list of drives and directories separated by semicolons — 
for example, c:\;c:\calc;c:\ data \ budget. 


The spreadsheet datapath, set with //File, Path, Spreadsheet, applies 
only to the current spreadsheet and is saved with the spreadsheet 
.cal file. This datapath indicates the drives and directories where 
the current and related spreadsheets are stored. For example, a 
spreadsheet with sales figures might be in a subdirectory 
c:\data\sales, so that subdirectory would be entered as the 
spreadsheet datapath. //File,Path,Spreadsheet,Zap clears the 
current spreadsheet datapath setting. 


1-22 SuperCalc Reference Manual 


File Retrieva | 


The global datapath, set with //File, Path, Global, applies to an 
entire work session. For example, each user sharing a hard disk 
or a network server might have a main directory where all data is 
kept. The global datapath is saved in SuperCalc configuration 
files with /Global, Keep. //File, Path, Global, Zap restores the global 
datapath entry that was last kept. //File, Path, Global, Clear 
removes the current global datapath. You can use /Global, Keep to 
make the datapath deletion permanent. 


If there is no global datapath, SuperCalc uses an alternative 
datapath, if any. You can set an alternative global datapath by 
including the command SET DATAPATH= in your 
AUTOEXEC.bat file, or by entering the command directly at an 
operating system prompt. 


For more about the //File commands, see Chapter 2. 


Invoking or Loading Files during Startup 


SuperCalc can perform a number of operations during program 
startup: 


m Automatically execute a file macro named AUTOEXEC.xqt. 
m Automatically load a spreadsheet file named AUTOEXEC.cal. 


@ Automatically invoke an add-in program set for auto- 
invocation with //Add-in, Attach,, Yes. 


m Execute a file macro specified after the program startup 
command. 


m Load a spreadsheet file specified after the program startup 
command. 


m Load and use a configuration file specified after the program 
startup command. 
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Startup Command, without File Names 
When you enter only the SuperCalc startup command (SC5) at the 
DOS prompt, SuperCalc looks for these files in this order: 


1. A configuration file named SC5.cfg. If not found, SuperCalc 
uses its preset defaults. 


2. A file macro named AUTOEXEC.xqt to execute. If not found, 
SuperCalc looks for a spreadsheet file named AUTOEXEC.cal 
to load. 


Search Order 
When looking for files, SuperCalc searches these directories in this 


order: 


1. Current logged directory (the directory from which SuperCalc 
was invoked). 


2. SuperCalc program directory (the directory containing 
SC5.com). 


Startup Command, with One File Name 
When you enter the startup command as: 


SC5 filename 


without giving a path or extension for the filename, SuperCalc 
searches for these files in this order: 


1. If filename is preceded by a slash (/), SuperCalc looks for 
FILENAME.cfg — A configuration file created with 
/Global, Keep, To. If found, SuperCalc uses the specified .cfg 
file to set program defaults. 


2. FILENAME.xqt — A macro file containing a set of macro and 


program commands. If found, SuperCalc executes the 
specified .xqt file. 


1-24 SuperCalc Reference Manual 


Invoking or Loading Files during Startup 


3. FILENAME.cal — A SuperCalc spreadsheet. If found, 
SuperCalc loads the specified .cal file. 


Note that whenever you load a spreadsheet, the program 
looks for a macro in that spreadsheet named \AUTOEXEC. If 
found, SuperCalc executes the macro. 


SuperCalc searches your directories in the order listed previously. 


If you specify a drive/directory path and file extension, SuperCalc 
will look for that exact file. 


Startup Command, with Multiple File Names 
When you enter the startup command: 


SC5 /file-1 file-2 


without file extensions, SuperCalc looks for FILE-1.cfg (since the 
filename was preceded by a backslash), then looks for FILE- 
2.xqt, and finally FILE-2.cal. 


Setup Strings 


This section describes how to use setup strings and options for 
the setup strings. A setup string is used to define font and 
character attributes, for example, ASCII characters, or boldface 
characters. 


Default Printer Setup String 


All printers have control codes which let you relay instructions 
(setup or initialization strings) to them. Refer to the printer 
manual for your printer’s functions and printer control codes. 
You can select printer control features from a menu using the 
Initialization option of the Output Options Menu, or you can 
enter printer control codes directly from the keyboard with the 
Setup option. 


To type in or update SuperCalc’s default printer setup string, 
select Setup from the Output Options Menu. Then, type the setup 
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string using ASCII control codes or their decimal equivalents. 
Decimals must be preceded by a back slash (\). For example, 
many Epson printers and compatibles use CtrL-O to specify 
compressed type. You can enter either CtrLO or \015 as a 
setup string. 


Header and Footer Setup Strings 


SuperCalc lets you insert printer setup strings into headers, 
footers, and spreadsheet text. You can, for example, boldface the 
title or insert special ASCII characters. 


To create or update a setup string in a header or footer, select 
Headers or Footers from the Output Options Menu. Then select 
the line number to be entered or edited and insert the setup string 
as follows: 


Vertical bar plus two colons ( l:: ) 
Setup string codes, ASCII characters or decimal equivalents 


Two colons plus a vertical bar ( ::1 ) 
Then press Return to enter the completed header or footer. 


The setup string vertical bar ( | ) can be included along with the 
left | center | right justification vertical bars. For example, to insert 
a setup string at the beginning of a three-part heading (alble ), 
use l::setup string::|alble. To print the middle part in boldface 
type, use al |::bold on codes: |b |::bold off codes::| lc. 


Body Text Setup Strings 


A setup string can be typed in the body of the spreadsheet. To 
add a setup string in the body of the spreadsheet: 


1. Go to the cell where you want to insert the setup string. 
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2. Type the setup string as follows: 
Two vertical bars ( II ) 
Printer control code 


Then press Return. 
For example, you type | 1\027 to enter the setup string Esc. 


The setup string must be in a row by itself and must appear in the 
first column of the output range. Anything else on the same row 
is not output. 


Setup String Characteristics 


A setup string can have a maximum of 240 characters. It can 
contain printer control characters or their decimal equivalent 
values. 


When entering printer control codes the EDIT mode cursor keys 
are available. 


If you are in macro LEARN mode, do not use control characters in 
the setup string because control codes cannot be learned. 

Instead, use the decimal equivalents. See the section on macros 
for more details. 


Decimal equivalent control characters must be preceded with a 
backslash (\). The backslash is followed by the three ASCII digits 
(000 to 255). For example, an Epson MX80 printer into 
compressed print mode is indicated by a Ctr-O; the decimal 
equivalent ASCII character is \015 If you enter Ctrl-O, the O 
displays in half-intensity. 


Certain characters require special attention when they are used in 
setup strings. The following is a list of the particular characters 


and how to implement them in setup strings. 


m To enter a backslash (\) as a printer control code, type it 
twice AV). 


m To enter Return as a printer control code, type 1013. 
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m To enter Del as a printer code, type 1127. 


@ To enter extended ASCII, type a backslash (\) then the three 
decimal numbers, or you can press Alt then type the three 
decimal numbers on your numeric keypad. 


Certain characters appear as an extraneous symbol on screen, for 
example Esc appears as a left bracket (D in half-intensity. 


Optimizing SuperCalc Performance 


SuperCalc offers several ways to optimize operating speed and/or 
memory usage. The following sections describe their use. 


Memory and Speed 


If you frequently use very large spreadsheets, multiple 
spreadsheets, or multipage spreadsheets, you may benefit from 
SuperCalc's /Global, Optimum, Next, Memory command. 


You can run SuperCalc under two different Memory settings: Fast 
and Data-space. 


The Fast setting optimizes the program for fast performance. If 
you have sufficient space in memory, SuperCalc loads the primary 
program files, reserving at least 64K for spreadsheet data. 
SuperCalc is shipped with this setting as the default. 


The Data-space setting optimizes the program for maximum data- 
space in memory (providing as much space as possible for your 
spreadsheets). SuperCalc does not load all of the primary 
program files into memory. Instead, the files are read from the 
the disk as needed. This may slow you down when you are 
using //Import or //Export commands, plotting a chart, or using 
other commands. The advantage, however, is that spreadsheets 
can be up to 174K larger in Data-space mode. 


To change your program’s Memory setting to Data-space and 
activate the new setting: 
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1. Select /Global,Optimum,Next,Memory,Data-space (or Fast, if 
you're returning to the default). 


2. Select /Global,Keep,Yes (or To,filename) to keep the new 
setting. 


3. To exit SuperCalc and immediately activate the new setting, 
select /Quit,To,SC5. 


When you start the program again, the program files are re- 
configured so they run as Data-space files. To return to Fast, 
follow steps 1 through 3, but substitute Fast for Data-space in 
step 1. 


Recalculation Features 


SuperCalc has a number of features that save time when 
recalculating your spreadsheet. 


Minimal Recalculation 


This feature, when activated, means that SuperCaic recalculates 
only cells that are affected by your last entry rather than 
recalculating the entire spreadsheet. For example, if you change 
a value in cell A4 and then recalculate, only formulas that 
reference that cell — either directly or as part of a range — will 
be recalculated, along with any formulas that reference the 
recalculated formulas, and so on. 


The default minimal recalculation setting is 

/Global, Optimum, Present,Minimal,Auto. This setting lets 
SuperCalc determine whether to recalculate the entire spreadsheet 
or just dependent cells. Change the setting from Auto to Yes if 
you want minimal recalculation every time. No sets SuperCalc to 
recalculate the entire spreadsheet every time. 


Recalculation Range 


/Global, Evaluation, Range lets you enter a spreadsheet range to be 
recalculated each time recalculation occurs. If you're working on 
only a small part of a very large spreadsheet and only want to 
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check value changes on that part, enter it as the evaluation range. 
Recalculation is faster, since it is limited to only a portion of the 
spreadsheet. 


Automatic versus Manual Recalculation ha 


When you receive SuperCalc, /Global, Evaluation, When is set to 
Auto, so recalculation occurs after each data entry. You can save 
considerable time when working with large spreadsheets if you 
select Manual instead of Auto. Then, recalculation occurs only 
when you press F9. 


Should you want to change back to automatic recalculation after 
every new entry, select /Global, Evaluation, When, Auto. 


Saving Memory 


Disabling Undo and Graphics 


SuperCalc's Undo feature provides a valuable safety net, however 
SuperCalc uses more memory when Undo is enabled. To disable 
Undo, select /Global, Optimum, Present, Undo,No. Select Yes to 
enable it again. 


Unless you are viewing and plotting charts, you can remove 
SuperCalc's graphics files from memory to use it for other 
purposes. Select /Global, Optimum, Next, Grapbics,No. Then select 
/Global, Keep, Yes or To and restart SuperCalc. 


Detaching Add-ins 


If you have attached and invoked an add-in program such as 
SILVERADO but won't be using it for awhile, select //Add- 

in, Detach to increase available memory. You must attach the 
add-in again before you can use it. 


Squeezing Formulas 


When you copy formulas, SuperCalc identifies them as copies and 
stores them in memory with a special space-saving method. If 
you've entered a number of formulas directly without copying, 
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you may find SuperCalc’s Squeeze option helpful. Select //Test or 
press Alt-F1 to enter AUDIT mode. Then, select /Squeeze. 
SuperCalc locates formula copies and compresses them to save 
memory. 


Expanding Memory 


If you frequently work with very large spreadsheets, or multiple 
and multipage spreadsheets, and graphics, you'll probably want to 
add an expanded memory board. Once installed, you may need 
to select /Global, Optimum, Next, Expanded to indicate how much 
of its memory you want to use for SuperCalc, All or Part (plus 
amount, from 0 to 32768 Kb). Select /Global, Keep, Yes or To, then 
quit and restart SuperCalc to activate the memory expansion. 


Hardware Considerations 


These sections will help you configure SuperCalc for best 
performance with your computer hardware. For more 
information about the commands mentioned in this section, see 
Chapter 2. 


IBM Enhanced Graphics Adapter Card and Other 
Adapters 


No special program installation is required for SuperCalc, but be 
sure to follow the instructions that came with the adapter card. 
The switches on the card must be set correctly for your monitor. 


Color Monitor 


If your color monitor display flashes or blinks when memory- 
resident programs are loaded, use 

/Global, Optimum, Present, Flash, Yes to assign an alternate color set 
and suppress these problems. 
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LCD Screen 


LCD (liquid crystal display) screens do not show differences 

between half and full intensities, and some chart details. You can 

improve the appearance of your screen display by selecting 

/Global, Optimum, Next, Attribute, Black/White. a 


Dual Monitors 


If you have a dual monitor system, spreadsheets display on the 
primary monitor and charts display on the secondary monitor (if it 
is connected to a graphics adapter card). This assumes the initial 
program default setting is in effect: 

/Global, Optimum, Next, Dual, Yes. 


To view charts and spreadsheets sequentially on one monitor, 
select /Global, Optimum, Next, Dual, No. 


/Global, Optimum, Next Selections 


When you change a setting with /Global, 
Optimum,Next, the setting must be kept to a 
configuration file with /Global,Keep and 
SuperCalc must be restarted before the setting 
will take effect. 


Math Coprocessor Chip 


If you have a math coprocessor chip in the 8087 NDP family 
(such as the 8087 or 80287), SuperCalc displays a message on the 
opening title screen to let you know that the chip is detected. If 
one is present, SuperCalc automatically adjusts its operation to 
take advantage of the chip. 
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HP LaserJet Printer 


Before printing a spreadsheet on the Hewlett-Packard LaserJet, be 
sure that you have installed the printer with 

/Global, Spreadsheet, Device and that you have selected 
/Output,Printer, Options, Paper, Auto Page, Yes. To save these 
settings as program defaults, use /Global, Keep, Yes or 

/Global, Keep, To. 


Hercules GraphicsCard 


To optimize screen display with a Hercules GraphicsCard, select 
/Global, Optimum, Next, Video, Hercules. 


Compaq Computer, Monochrome Graphics 
Monitor 


Select /Global, Optimum, Next, Video, Compag for optimum display 
with a Compaq computer. 


If your computer has a color graphics board and a monochrome 
monitor, there may be spreadsheet display problems: the 
spreadsheet border characters, protected cells containing the cell 
cursor, and some messages normally displayed in certain colors 
may be unreadable. These problems also occur when using 
Compaq computers with monochrome monitors. 


To improve the display, start SuperCalc with this command: 
SC5/BW. This command lets you see all spreadsheet colors in 
shades of gray. To change SuperCalc display defaults, select 
/Global, Optimum, Next, Attribute, Black/White. Then, use 
/Global,Keep to preserve the setting and put it into effect by 
quitting and restarting SuperCalc with SCS. 


Expanded Memory Board 


When using Intel Above Board or other supported memory 
expansion boards, select /Global, Optimum, Next, Expanded to 
indicate the amount of memory you want to use for SuperCalc. 
To use all available memory, select All, otherwise, select Part and 
enter 0 to 32768 Kb. 
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Chapter 2 
SuperCalc Commands 


Whats in this Chapter? 


The commands that control SuperCalc’s operation are sometimes 
called slash commands because you type the slash character (/) to 
display the main menu: 


Blank Copy Delete Edit Format Global Insert Justify Load Move 
Name Output Protect Quit Save Title Unprotect Windou dap 1-2-3 “more 


277 
MENU Sort spreadsheet (or specified range) by a column or row 


You then select the command you want by moving the cursor to 
it and pressing Return, or by typing the command’s first (or 
capitalized) letter. For example, to use the /Move command to 
move data, you type /M to activate the command. When you 
highlight a command with the cursor, a brief definition of the 
command displays on the help line at the bottom of the screen. 


Most commands have additional options. When you choose a 
command with options, the menu changes to show the choices 
available. You are prompted through the entire sequence. 


When you type two slashes (//), a second menu displays: 


Data Export File Graphics Import Macro Network Restrict 
Spreadsheets Test 
3/4 


MENU Attach, detach, invoke Add-in programs 


This menu is just a continuation of the first; you select its 
commands the same way. 
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What’s in this Chapter 


This chapter contains a map of all the commands, and an 
overview of commands on both the / and // menus. These 
sections are followed by definitions of each command, presented 
in alphabetical order as they appear on the menu. Also see 
Appendix E, which lists commands according to the functions 
they perform. 
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Command Map 


/Arrange, - Block,range, — Go 
1stkey,range, E Ascending 


Descending 
2ndkey,range, paang 
Descending 
3rdkey,range, 3 Ascending 
Descending 
Options, C Column-wise,(Yes/No) 
Adjust,(Yes/No) 
Zap 
Quit 


Column,column C (entire column, ascending sort, no adjust) 
, range, 3 Ascending 3 C Adjust 7 
Descending No-adjust 


p Options,column, ji Ascending 
Descending 
i CE) (entire column, ascending sort, no adjust) 


, range, - Ascending Adjust > OMA 
L Descending al g No-adjust J 


Row,row 


p Options,row, m Ascending 
p Descending 


/Blank, po (current cell) 
range e (All) 
, All 
Contents 


/Copy, from range (extended),to range (extended) E (adjust references) 
No-adjust 
Ask 
Values 
+ (add) 
— (subtract) 
* (multiply) 
/ (divide) 
Transpose 


/Delete, — Row,row range 
Column,column range 
Block,block range,(Up/Left) 
File, filename,(No/Yes) 
Page, page range 
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/Edit,source cell (extended) k (edit into current cell) 


, destination cell 


Global 
Column,column range 
Row, E row range 

Remaining ()254) 
Entry,range 


/Format, 


User-define, 


Number, 


Quit 
1 


N DONARAN 


ap 
Quit 


Date, 


9 


Accept 
Integer 
General 
Exponential 
$ 
Right 
Left 
Center 
Text,(Left/Right/Center) 
User-defined, i Number,(1-8) 
Date,(1-8) 
Hide 
Default 
Width, column width 
(Global and Column only) 


Quit 
Before,(Default/None/Enter, string) 
After,(Default/None/Enter, string) 
Thousands,(Yes/No) 
Minus,(Yes/No/Float) 
Percent(Yes/No) 

Decimal,(O-—7) 

Zero,(Yes/No) 

Scaling,(O-7) 


1 date/time format string 
2 date/time format string 
3 date/time format string 
4 date/time format string 
5 date/time format string 
6,date/time format string 
7 date/time format string 
8 date/time format string 
T date/time format string 


Zap 


Hide-column,column range,(Yes/No) 
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/Global, — Optimum, Present, — Punctuation,(1-8) 

Before, C None 

Enter, string 
After, J None 

Enter, string) 
Time,(12hr/24hr) 
Minimal,(Auto/Yes/No) 
Interruptible,(Yes/No) 
Undo,(Yes/No) 
Extension,(CAL/wk1/wkS) 
Regraph,(Auto/Manual) 
Flash,(Yes/No) 
LICS,(Yes/No) 
Quit 

Next, Memory,(Fast/Data-space) 
Boundary,(Auto/Small/Medium/Large) 
Expanded, ee 
Part,memory to use: 
0-32768kb 

Video, (IBM/Compaq/Hercules) 
Attribute,(Auto/Color/Black/White) 
Graphics,(Yes/No) 
Dual,(Yes/No) 


Quit 
Quit 
Keep, Yes 
No If name found: 
To, filename Backup 
- Change 
Overwrite 


Spreadsheet,All 

Graphics, - All 
Colors 
Globals 
Others 
Text 


From, filename, L All 
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Graphics, Quit 
Device, — B&W-printers, point to device name 
(C€) to select) 
Color-printers, point to device name 
(€) to select) 
Plotters, point to device name 
(C€) to select) 
Layout,(graph size/position) 
Options, - Parallel, — 1 = LPT1: 
- 2 =LPT2: 
A= LPT: 
Serial, Com, - 1 = COMI: 
2 = COM2: 
3 = COM3: 
4 = COM4: 
Baud, = 110 
2=150 
3 = 300 
4 = 600 
5 = 1200 
6 = 2400 
7 = 4800 
8 = 9600 
9 = 19200 
Parity, — Odd 
- Even 
None 


Data-bits,(7/8) 
Stop-bits,(1/2) 
DOS 
Check,(Yes/No) 
Auto 
Zap 
Quit 
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Spreadsheet, — Quit 
Cartridges, - 1 


(Ce) to select) 
(Ce) to select) 


2 
3 
Softfonts,(1/2/3/Quit) 
Quit 
Device, B&W-printers, point to device name 
i Color-printers point to device name 
Fonts, Default , — Face 
1 Point-size 
2 Bold,(Yes/No) 
3 Italic,(Yes/No) 
4 Quit 
5 
6 
7 
Quit 
Options, - Parallel, — 1 = LPT1: 
- 22 LP 2: 
3 = LPT3: 
Serial, Com#, - 1 =COM1: 
2=COM2: 
4 =COM3: 
4 =COM4: 
Baud, TITO 
2=150 
3 = 300 
4 = 600 
5 = 1200 
6 = 2400 
7 = 4800 
8 = 9600 
9 = 19200 
Parity,(Odd/Even/None) 
Data-bits,(7/8) 
Stop-bits,(1/2) 
DOS 
Check,(Yes/No) 
Auto 
Formfeed,(Yes/No) 
Zap 
Quit 


Translation-tables ((€) to select) 
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Command Map 


Evaluation, Quit 
Order,(Dependent/Row/Column) 
When,(Manual/Auto) 
Iteration-control, Solve,(Quit/Delta/Range) 
Fixed,iteration count: 1-99 
Range,range (“-” to clear) 
Values 
1-2-3 
+ ¡(Formula/”/Labels/Protection/Border/Next/Tab/Unprotected/Zoom) 
— (Formula/” /Labels/Protection/Border/Next/Tab/Unprotected/Zoom) 
Formula 
” 
Labels 
Protection 
Border 
Next 
Tab 
Unprotected 
Zoom 
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/Insert, ~ Row,row range 
Column,column range 


Block,range, I Down (move old range data down) 


Right (move old range data right) 
Page, page range 


Justify, — Single, block range,(Left/Center/Right) 
- Multiple,block range,(Left/Center/Right) 
Word-wrap, - Go 

i Range, input range 
Width, column width 


/Load, filename, - Replace {Modification? No/Yes} 
All 
Values 
Consolidate 


Part, from range,to range C 
, m No-adjust 
Ask 
Values 
+ 


* 


/ 
Names 


Graphs, from chart,to chart 

Single, page, — Replace {Modification? No/Yes} 
All 
Values 
Consolidate 


Part, from range,to range i 
, r No-adjust 
Ask 
Values 
+ 


* 


/ 
Names 


Graphs, from chart,to chart 
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/Move, r Block, from range,to range i 
{ Normal 

a Transpose 

Row, from row range,to row number 

Column, from column range,to column letter 

Page, from page range,to page range 


/Name, - Create,range name,range 
Delete, range name 
Labels, r Right,range 
Down, range 


Left,range 
Up,range 
Table,range 
Zap, No 
Yes 
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/Output, - Printer ,  Range,range 
File, filename J Go 
Console 
Line-advance 
Page-advance 
Options, - Quit 
Report, - Quit 
Formatted,(Final/Draft/No) 
Contents, Yes 
No 
Highlighted 
View 
Spool,(Yes/No) 
Layout, - Quit 
Page-length,value 
Width,value 
Left,value 
Top,value 
Bottom,value 
Orientation, a Portrait 
Landscape 


Paper, Quit 
Wait,(Yes/No) 
Auto-page,(Yes/No) 
Double-spacing,(Yes/No) 
Line-feed,(Yes/No) 
Titles, — Auto 
Manual, - Quit 
Horizontal-range, 
range 
Vertical-range,range 
None 
Copies,value 
Borders, — Quit 


Auto 
Yes 
No 
Character,character 
„e Quit 
Footers - (1-4), string 
Fonts, — Default 


1-7 
Setup,string 
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Command Map 


Attributes, 


Grid, 


Lines, | 


New-page,range 


Zap, 


Align 


All 
Report 
Layout 
Paper 
Titles 
Copies 
Borders 
Headers 
Footers 
Setup 


Width,column range 


Quit 
Quit 


Fonts, 


Border, 


Shade, 
L 


Horizontal, range, ñ 


Vertical,range, 


Clear, range 
Set,range, i Default 


($7) 
Quit 
Top, J Clear,range 
Set,range 
Bottom, E Clear,range 
Set,range 
Left, fe Clear,range 
Set, range 
Right, C Clear,range 
Set, range 
Outline, r- Clear, range 
L Set,range 


Clear range 
Clear,range 
Set,range 


Single,(1-5) 
Double,(1-5) 
Single, (1-5) 
Double,(1-5) 
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/Protect, i (current cell) 


range 


/Quit, r No 
Yes 
To, program name (must be .COM file) 
If name found: 
Save, filename į , — Backup 
Overwrite 


DOS 


If name found: 


/Save, filename | , — Backup FAL 
- Change Values 
Overwrite Part, Bion from range 
Values, from range 
Duplicate 
Level, sc5 
scs 
sc3 
Mode, - All 
l- Protected 
Unprotected 
Single, - All 
Values 


Part, I All, from range 
Values, from range 


Duplicate 
Level, sc5 
- sc4 
sc3 
Mode, - All 
- Protected 
Unprotected 


/Title, — Horizontal 
Vertical 
Both 
Clear 
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Command Map 


/Unprotect, i (current cell) 


range 


/Window, m Horizontal 
Vertical 
Clear 
Synchronize 
Unsynchronize 


/Zap, - No 
Yes If name found: 
Save, filename į , — Backup 
Overwrite 
Page 


/1-2-3 (execute single Lotus 1-2-3 command) 


//Add-In, p- Attach, filename, — None,(No/Yes) 

1,(No/Yes) 
2, (No/Yes) 
3,(No/Yes) 
4 (No/Yes) 
5,(No/Yes) 
6,(No/Yes) 
7 (No/Yes) 
8,(No/Yes) 
9 (No/Yes) 
0,(No/Yes) 

Detach, filename 

Invoke, filename 

Zap, (No/Yes) 


Quit 
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//Data, — Quit 

Input,range 

Criterion,range 

Output,range 

Find, (for next record) 
(for previous record) 
(for next field) 
(for previous field) 
to end 

Extract 

Unique 

Select, Yes 
No 
(for next field) 
(for previous field) 
to end 


Remain 
Delete, Yes 
No 
Remaining 
(for next record) 
(for previous record) 
to end 
Analysis, 3 Distribution,input range,bin range 
Regression, - Go 
X-Range,range 
Y-Range,range 
Output,range 
Fit (Linear/Quadratic/Cubic) 
Intercept,(Calculate/Zero) 
Zap 
Quit 
Block,range, - Number, start value step value stop value 
Growth, start value step value stop value 
Date, - Day, start value step value 
stop value 
Week, start value step value 
stop value 
Month,start value step value 
stop value 


Order, - Column 
Row 
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Invert,rangel output range 
Solve, rangel output range 
Parse, Go 
Create, cell 
Edit,cell 
Input, column range 
Output,column range 
Zap 
Quit 
Table, i 1,table range, input cell 


Matrix, L Multiply,range1 ,range2 output range 


2 table range, input celll ¡input cell2 
Zap 


//Export, — XDIF, filename Backup , All 
Change i Values 
Overwrite Part, ? All, from range 
Values, from range 


DIF filename A E change , m Colwise 7 g I All 


Change Rowwise Part, from range 
Overwrite 
CSV, filename Backup ‘ C All 
Change Part, from range 
Overwrite 
dBase, filename|, — Backup , a 
- Change Part, from range 
Overwrite 


//File, — Directory,default directory name 
List, SuperCalc 


1-2-3 

Print 

Macro 

Config 

All 

Path, — Global, Edit,drive/directory search paths 
- Clear 

Zap 

Spreadsheet, i Edit,drive/directory search paths 
Zap 
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Command Map 


//Graphics, - View 

Type, Bar 
Pie 
Dual 
Line 
Area 
Hi-Lo 
X-Y 
Radar 
Word 
Data 
Labels, — Quit 
Axis-labels 
Legend-labels 
Data-labels 
Titles 


Axis 
Options 


| 
| 


PIC-file, filename 

CGI, - Display 
Slide 
Printer 
pLotter 
Camera 
Metafile 


Drivers, L Normal 


Options 

Retrieve, chartname 
Store chartname 
Delete,chartname 


Name, 


Zap 
Plot 
Zap, No 
Yes 
Quit 
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/IlImport, — XDIF filename, — Replace 
All 
Values 
Consolidate 
Part, from range,to range 4 
, ~All 


Values 
epe 


{Modification? No/Yes} 


* 


/ 


7) Replace {Modification? No/Yes} 
E All 


Consolidate 


Part, from range,to did i 


» m Values 
+ 


DIF filename, - Colwise 
Rowwis 


* 


/ 
CSV, filename, p Replace 


All 
Consolidate 


Part, from range,to range ig 


, r Values 
+ 


{Modification? No/Yes} 


* 


/ 
Replace {Modification? No/Yes} 


Numbers, filename, ' 

Part, from range, to range 

Text, filename, Replace {Modification? No/Yes} 

Part, from range,to range 

VisiCalc, filename, p Replace {Modification? No/Yes} 
i All 

Part, from range,to range 


Replace {Modification? No/Yes} 
All 


Extract 
Names 


dBase, filename, 
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//Macro, m Learn,range 
Read, filename,range, All 
Macros-only 
Labels-macros 
Comments-macros 
If name found: 


Write, filename |, r Backup , range, - All 
- Change Macros-only 
Overwrite Labels-macros 


Comments-macros 
eXecute, filename 
Analyze, Go 
Range,range 
Type, ' Contents,(Yes/No) 


Transfers, (To/From/Both/None) 
Modifies,(Affects/Changed by/Both/None) 


Output, Printer 
File, filename , m Backup 
- Change 
Overwrite 
Console 
Quit 
Breakpoint, mes Location, io a 4 
Zap File, filename,record 
Condition,cell 
Zap 
Convert, SC 7 3 Foe 
1-2-3 Range,range 
Trace, Console 
l- Printer 
File, Open, filename |, — Backup 
- Change 
Overwrite 


Close, filename 


Link,drive,network path 
Unlink,drive 
Lock, filename 
Unlock, filename 
Output, m Quit 
1=LPT1 ] i O 


//Network, - Directory, : Quit 


= LP T2 End-redirection 
4=LPT3 
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Command Map 


//Restrict,range 


//Spreadsheets, — Display, - 1 


2 

3 

Synchronize 

Unsynchronize 

Zoom, r Yes 
No 

Goto, Next 
- Previous 


Specify,sheet/page 
Hide, sheet/page 
New 
Rename,name 
Save f Backup 
Overwrite 
Unhide,sheet/page 
Zap, No 
l- Yo 
Save : Backup l 


Overwrite 
Quit, — No 
l- Ye 
Save i Backup 
Overwrite 
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//Test or Alt-F1 to enter AUDIT mode, then: 


/ - Details 
Highlight, — Area, Filter, All 
Current 
Highlighted 


Not-highlighted 
Range, range 
Block,range 
Cells, Attribute 


Blank-ref 
Constant 
Date 
Error 
Formula 
Hidden 
Invariant 
Lone 
Macro 
NA 
fOrmat 
Protected 
Referenced 
String 
Time 
Unprotected 
emptY 
Find, Contents, — Go 
Case, Any 
Exact 
Labels, Yes 
No 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Relation, pore 
Not-equal 
String,string 
Quit 
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Command Map 


oe Numbers, — Go 
Relation, fp Equal 
Not-equal 
Above 
Below 
Greater/equal 
Less/equal 
Value,value 
Quit 
Text, Go 
Case, Any 
Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Relation, es 
Not-equal 
String,string 
Quit 
Links, Dependent 
Modified, Yes 
No 
Output-attr, All 
Border, All 
Top 
Bottom 
Left 
Right 
Fonts, All 
1 
2 
3 
+ 
5 
6 
E 
Shade 
Pre-zap, YES 
No 
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Relationships, Circ 
Dependent, p Direct 
Nested 
Group, All 
- First 
None 
Supporting, - Direct 
Nested 


| Zap 
Names, Bounds 
Duplicate 
Overlap 
Reversed 
Unreferenced 
Replace, Go 
Range,range 
Old-string,string 
New:string, string 


Case, Any 
Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Prompt, - Yes 
No 
Labels, Yes 
No 
Quit 
Squeeze 
View, Normal 
Formula 
Map, Pattern 
Standard ` 


Quit 
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j 


Command Map 


Command Summary 


This section briefly describes each command, in alphabetical 
order. 


/Arrange 


Sorts a block of cells in ascending or descending order, with or 
without cell reference adjustment. Allows multi-key sorts of 
columns and rows. 


/Blank 


Erases the contents of the current cell, cells in a specified range, 
or unprotected cells. Resets Entry level formatting to the default 
setting, or retains current Entry level formatting. 


/Copy 


Duplicates cell contents, cell values, and Entry level display 
formats. Duplicates cells from one spreadsheet to another. Does 
formula adjustment, copies values only, transposes rows and 
columns, and adds, subtracts, multiplies, or divides the source cell 
values by the destination cell values. 


/Delete 


Removes a row range, column range, block, or disk file. The 
remaining data is adjusted, including formulas. 


/Edit 


Edits a source cell’s contents, and puts it in a destination cell. 
The source cell may be in any spreadsheet in memory; the 
destination cell must be in the current spreadsheet. 


/Format 


Controls display formats (on screen) and the appearance of 
printed output. Defines numerical format, sets column width, 
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Command Summary 


determines appearance of dates, and times, justifies values or text 
within cells. 


/Global 


Establishes feature settings for the entire spreadsheet, including 
hardware and program default settings. 


/Insert 


Inserts an empty row range, column range, or block, and adjusts 
formulas. 


/Justify 


Wraps entered text around a specified range of columns, justifies 
text flush left, right, or center after entry; wraps text over a 
specified range of columns as you type. 


/Load 


Loads all or part of a spreadsheet’s contents, values, and format 
settings from a disk file. Loads Lotus 1-2-5 files. 


/Move 


Moves a row range, column range, or block to a new location and 
adjusts the formulas. Also can transpose a block of data from 
rows to columns, and vice versa. 


/Name 


Establishes a name for a cell range; creates a table of range 
names. 


/Output 


Sends all or part of a spreadsheet to a printer or disk file. Allows 
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printing of multiple ranges on a single pages, and lets you 
preview output on-screen. Puts titles, headers, footers, and 
margins on output; applies fonts, lines, and shading to cells. 


/Protect 


Prevents any changes to cell contents and to blank cells formatted 
at the Entry level 


/Quit 


Exits SuperCalc or the current spreadsheet, and either returns you 
to the operating system, the next spreadsheet in memory, or 
begins another (.com) program. 


/Save 


Writes all or part of a spreadsheet to a disk file. Has options to 
write calculated cell values only, or protected/unprotected cells 
only. Can save in formats compatible with SuperCalc3 and 
SuperCalc4, as well as Lotus 1-2-3. 


/Title 


Locks columns, rows, or both on-screen. Keeps reference labels 
in view while you scroll through the spreadsheet. 


/Unprotect 


Removes protection (applied with /Protect) from a specified 
protected range. 


/Window 


Splits the display window horizontally or vertically into two parts. 
Allows simultaneous or independent scrolling of the windows. 
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Command Summary 


/Zap 


Erases a spreadsheet from memory, leaving a blank display 
window. The file on disk is not affected. 


/1-2-3 


Executes a command via Lotus 1-2-3’s menu structure. 


//Add-in 


Attaches, invokes, and detaches compatible add-in programs and 
functions for use in SuperCalc. Allows linking of add-in programs 
to function keys, and can establish automatic invocation of a 
single add-in. 


//Data 


Locates, extracts, or deletes selected data, computes frequency 

distributions and multi-variable regression analyses, performs 

matrix multiplication and inversion, solves simultaneous — 
equations, generates data ranges, parses continuous data records 

into fields, calculates one- and two-variable “what-if” tables. 


//Export 


Saves a spreadsheet to disk in any of these file formats: XDIF, 
DIF, Comma Separated Values (CSV), and dBase III. Use /Save to 
save to a Lotus 1-2-3 file format. 


//File 


Allows creation of global and spreadsheet datapaths, to guide 
automatic file searches. Displays the File List for the specified file 
type and changes the default directory. 


//Graphics 
Displays spreadsheet data graphically in the following types of 
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charts: bar, line, bar and line, pie, hi-lo, including three- 
dimensional and exploded charts. 


//Import 


Loads files created by other programs. Imports the following file 
formats: XDIF, DIF, CSV, Numbers (and "text in quotes"), Text 
(ASCII text files), VisiCalc, and dBase III. Use /Load to load a 
Lotus 1-2-3 file. 


//Macro 


Helps create and debug SuperCalc macros, converts Lotus 1-2-3 
macros to SuperCalc format. 


//Network 


Allows sharing of network resources in a supported network 
environment. 


//Restrict 


Restrict data input to a specified range. 


//Spreadsheets 


Allows more than one spreadsheet in memory at a time, displays 
up to three spreadsheets on-screen at once, lets you move among 
open spreadsheets, and hide them from view. 


//Test 


Offers commands for viewing your spreadsheet in formula and 
map view, highlighting related cells, tracing errors, identifying 
various cell relationships, and finding and replacing text and 
formulas. 
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/Arrange 


/Arrange sorts your spreadsheet data based on the cell values of 
up to three columns or rows. The main options are: Block, = 
Column, and Row. 


/Arrange, - Block,range, — Go 

Istkey,range, oe 
Descending 

2ndkey,range, ae 
Descending 

3rdkey,range, ASAS 
Descending 

Options, E Column-wise,(Yes/No) 
Adjust,(Yes/No) 

Zap 

Quit 

Column,column É (entire column, ascending sort, no adjust) 


, range, — Ascending Adjust ae 
i Dem L No-adj ae 


Go 

L Options,column, E Ascending as 
Descending 

Row,row ig (e) entire column, ascending sort, no adjust) 


, range, — Ascending Adjust eee 
y Descending a L EAE 


a Options,row, - Ascending 
EF Descending 


When you sort using a row as a key, the columns within the sort 
block are arranged; when you sort using a column as a key, the 
rows within the sort block are arranged. 


/Arrange,Block 


Lets you specify up to three sort keys, in ascending/descending 
order. When you select /Arrange,Block, you’re prompted to 
specify the range of the spreadsheet you want to sort. 


After specifying the range, a menu displays the following options: 
Go, Istkey, 2ndkey, 3rdkey, Options, Zap, and Quit. 
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To perform a multi-level sort, select 1stkey, indicate the primary 
column or row by which to sort, then choose Ascending or 


Descending. Continue with 2ndkey and 3rdkey, then select Go to 


begin the sort. 


See the section Sort Options later in this chapter for a description 
of the options Ascending, Descending, Adjust, and No-adjust. 


/Arrange,Block,Go 


Performs the sort, using whatever keys and options you’ve 
already specified. 


/Arrange,Block, 1stkey 


Indicates the column or row to be used as the primary sort key. 
After you specify the column or row, choose either Ascending or 
Descending order. 


/Arrange,Block,2ndkey 


Indicates the secondary sort key. After specifying the column or 
row, choose Ascending or Descending order for this key. 


The secondary sort is similar to the primary sort. If the first sort is 


on a row, the secondary sort must also be on a row (the same is 
true for columns). A secondary sort is a tie-breaker. For 
example, if a primary sort contains ten “Smith” entries, a 
secondary sort by first name, or by salary or another field, is 
generally called for. 


/Arrange,Block,3rdkey 


Indicates the tertiary sort key. Specify the column or row, then 
select either Ascending or Descending order. 
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/Arrange,Block,Options 


Lets you choose a column-wise or row-wise sort, and whether to 
adjust formulas. 


Column- Determines whether data is sorted row-wise 
wise or column-wise: 
a Yes Sorts down the columns, 


rearranging the rows. 


g No Sorts across the rows, 
rearranging the columns. 


Adjust Determines whether formulas adjust: 

3 Yes Adjusts formulas. 

a No Does not adjust formulas. 
/Arrange,Block,Zap 


Clears all existing sort key (1stkey, 2ndkey, and 3rdkey) ranges 
and the Block range. 


/Arrange,Block,Quit 


Exits the /Arrange menus and returns you to READY mode. 


/Arrange,Column 


Rearranges the sort block so that cells in the key column within 
that block are in ascending or descending order. 


You must specify the key column by moving the cursor to point 
to the key column or entering the column letter directly. 


If you enter the key column by pressing Return, the entire 


spreadsheet is sorted in Ascending order, without adjustment. To 
specify otherwise, press a comma (,) instead of Return. 
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/Arrange,Column Options 


By following the key column with a comma (,) instead of Return, 
you can specify which part of the spreadsheet to sort, Ascending 
or Descending sort order, and Adjust or No-adjust for formulas. 


See Sort Options later in this section for descriptions of Ascending, 
Descending, Adjust, and No-adjust. 


/Arrange,Row 


Rearranges the sort block so that cells in the key row within that 
block are in ascending or descending order. 


You must specify the key row by moving the cursor to point to 
the key row or entering the key row number directly. 


If you enter the key row by pressing Return, the entire 
spreadsheet is sorted in Ascending order, without adjustment. To 
specify otherwise, press a comma (,) instead of Return. 


/Arrange,Row Options 


By following the key row with a comma (,) instead of Return, 
you can specify which part of the spreadsheet to sort, Ascending 
or Descending sort order, and Adjust or No-adjust for formulas. 


See Sort Options later in this section for descriptions of Ascending, 
Descending, Adjust, and No-adjust. 


Sort Options 


Ascending 

Sorts in the following order: 

m space (" ) as a text entry (blank cells aren't sorted) 
= punctuation 

m aAbBcC...zZ 

m Graphics (extended ASCII) 

= 0.9 
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Descending 
Descending sort order is: 


m Graphics (extended ASCII) 

a  ZZYyXx...Aa 

= punctuation 

m space (" ) as a text entry (blank cells aren't sorted) 
ae 9...0 


Adjust 


Sorts your spreadsheet, then adjusts the formulas. If 
/Global, Evaluation, When,Auto is in effect, it also recalculates each 
formula as it sorts. 


When sorting records (rows) in a block of data, the integrity of 
formulas is retained only when all cell references in each row 
refer just to that row (for example, A1+B1 in row 1). 


No-adjust 


Does not alter the cell formulas or recalculate values. This is the 
default. 


Examples 


To arrange all columns by row 4 (defaults are ascending sort 
order and no formula adjustment), enter: 


/Arrange,Row,4 


To arrange all rows by column C (default options are ascending 
sort order and no formula adjustment), enter: 


/Arrange,Column,C 
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To arrange the block A1:F10 by row 7 in ascending sort order, 
enter: 


/Arrange,Block,A1:F10,Options,Column- 
wise,No, Istkey,7,Ascending,Go. 
To arrange the block A1:F10 by column D using descending sort 


order, enter: 


/Arrange,Block,A1:F10,1stkey,D,Descending,Go 


To arrange A1:F2000 by column first on column A (ascending), 
then on column B (descending), enter: 


/Arrange,Block,A1:F2000,1stkey,A, Ascending, 
2ndkey,B,Descending,Go 


Stable Sort — More than Three Keys 


SuperCalc’s /Arrange command performs a "stable" sort; when 
two values in a key field are equal, the existing order of those 
two records is preserved. This means that you may sort on any 
number of keys (up to 9999 for /Arrange by Row). Just use 
/Arrange repeatedly in reverse order, starting with the last key 
and successively arranging with more important keys. For 
example, suppose you had a database with these columns and 
fields: 


A B C D E F 
Last Name First Name City State Zip Code County 


You can use /Arrange, Block twice to sort records in this order: 


State 
County 
City 
Zip Code 
Last Name 
First Name 


For the first sort, enter column E for 1stkey, column A for 2ndkey, 
and column B for 3rdkey to arrange the three lowest-level fields. 
For the second sort, enter column D for 1stkey, column F for 
2ndkey, and column C for 3rdkey. Choose either Ascending or 
Descending order for all sorts. 
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/Blank 


Erases the contents and removes the Entry level formatting set 
with /Format, Entry. Column, Row, and Global display formats 
are unaffected. 


/Blank, ji (4) (current cell) 
range ity (€) (All) 
All 
Contents 


/Blank 


/Blank followed by pressing Return erases the contents of the 
current cell and removes Entry level display formatting. 


/Blank followed by a cell range and Return erases the contents 
of all unprotected cells in the specified range. Entry level 
formatting is also removed. 


/Blank Options 


/Blank followed by a range and a comma (, ) offers these 
options: All, Contents. 


/Blank,All 


Erases the contents of all unprotected cells in the range, and 
removes Entry level formatting. 


/Blank,Contents 


Erases the contents of cells in the range, but does not remove 
Entry level formatting. 
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Examples 

Blank a single cell: /Blank,C7 Return 
Blank a block of cells: /Blank,C7:H12 Return 
Blank an entire column: /Blank,C Return 
Blank all unprotected cells, /Blank,ALL,Contents 


retain Entry level formats: 
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/Copy 


/Copy duplicates the cell contents (formulas), cell values, and 
Entry level display formats into a new spreadsheet location. The 
-source range remains intact. /Copy offers a choice of formula 
adjustment or consolidation arithmetic. You can transpose the 
rows and columns of a range, and copy cells from one 
spreadsheet to another. 


/Copy, from range (extended),to range (extended) 4 (adjust references) 
; No-adjust 
Ask 
Values 
+ (add) 
— (subtract) 
* (multiply) 
/ (divide) 
Transpose 


Copying Cells and Ranges 


/Copy first prompts for the source range (from, the cell or block of 
cells to be copied) and then for the destination range (to, where 
the copy will be placed). The actual copy depends on the shape 
of the source block. 


m When the source range is a single cell, that cell is copied over 
the entire destination range: /Copy,A1,D2:E4 


COPY COPY 
COPY COPY 


COPY COPY 
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m When the source range is a partial column, the source is 
copied into all columns of the destination range using the 
uppermost cells: /Copy,A2:A4,C:E. 


" When the source range is a partial row, the source is copied 
into all rows of the destination range using the leftmost cells: 
/Copy,B2:D2,4:5. 


COPY THESE CELLS. 


THESE CELLS. 
THESE CELLS. 


m When the source range is a block, the source is copied at the 
upper left cell of the destination range. The size of the 
source block determines the lower right target coordinate; 
SuperCalc will disregard an explicitely specified lower right 
coordinate: /Copy,A1:B2,C3:G9. 


SMALL BLOCK . 


COPY THIS 
SMALL BLOCK, 


You can use SuperCalc’s extended sheetname!range reference 
syntax to specify a source or destination range in another 
spreadsheet, as long as both spreadsheets are in memory. 
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For example, /Copy,A1,2!A1 will copy A1 in the current page of 
this sheet to Al in page 2. 


The /Copy options let you specify formula adjustment, 
consolidation arithmetic, or transposition for the destination 
range. Pressing Return after specifying the destination cell or 
range accepts the default option, formula adjustment. To select 
another option, type a comma (,). 


/Copy Options 
/Copy (from) (to) followed by Return copies and adjusts formulas 


to their new location. 


If you enter the target cell or range by typing a comma (,) instead 
of pressing Return, these options display: No-adjust, Ask, Values, 
+, -, * /, Transpose. For more information about +, -, *, and /, see 
Consolidation Arithmetic in the /Load section later in this chapter. 


/Copy,No-adjust 


Copies cell contents literally, with no formula adjustment. 


/Copy,Ask 


Prompts for formula adjustment for each cell copied. The entry 
line displays the formula and the prompt line displays the source 
cells. SuperCalc prompts for each cell reference adjustment. 


/Copy,Values 


Evaluates formulas, where present, and copies their values only, 
not the actual formulas. Dates change to their DVAL function 
value, times to their TVAL function value. Only numeric and 
string constants are entered in the destination cells. 


/Copy,+ 


Adds each source cell value to the corresponding destination cell 
value and enters the sum into the destination cell as a numeric 
constant. 
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/Copy,— 


Subtracts each source cell value from the corresponding 
destination cell value and enters the difference into the 
destination cell as a numeric constant. 


/Copy;,* 


Multiplies each source cell value by the corresponding destination 
cell value and enters the product into the destination cell as a 
numeric constant. 


/Copy,/ 


Divides each destination cell value by the corresponding source 
cell value and enters the quotient into the destination cell as a 
numeric constant. 


/Copy,Transpose 


Copies a block or row range and transposes the rows and 
columns in the new location. Formulas are automatically 
adjusted. 


You cannot transpose a full column into a row since a full column 
is larger than a full row. 


Overlapping Ranges 


If you overlap the from and to ranges, the from 
range overwrites the fo range. 


Examples 

Copy cell to cell: /Copy,B9,C12 Return 
Copy partial row to partial /Copy,B9:G9,H12 Return 
row: 
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Copy a partial column into a /Copy,B3:B7,D3:J3 Return 
group of partial columns: 


Copy a block range and /Copy,B2:C6,E2,Transpose 
transpose it: 


Copy without adjustments: /Copy,B9,C12,No-adjust 


Copy, and ask for individual /Copy,B9:B15,E9,Ask 
choice of adjustments: 


Special Considerations 


1. The +, -, * / options do not affect a cell that does not 
contain a formula entry with a numeric value. 


2. The +, -, * / options perform the indicated calculation 
between cells and replace the destination cell contents with 
the calculated value as a numeric constant. 


3. The Backspace key backs out of the options menu. 


4, See Consolidation Arithmetic under /Load, later in this 
chapter, for more details on consolidation. 


pi Cells can be copied into themselves. This can be used for 
such things as freezing values or saving memory. 


6. The maximum length of a formula is 240 characters 
(although some formulas require more storage space which 
reduces the character maximum). When copying a formula 
down rows, be sure to leave space for more characters. 
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For example, if a formula in row 4 references cell B4, and 
you copy it with adjustment to row 1000, the formula adjusts 
to reference cell B1000 which increases the formula length 
by 3 characters. SuperCalc will drop any characters over 

the maximum of 240. 


/Copy will not copy over protected cells. Blank cells will 
not copy over cells with entries. 


Use the $ to specify absolute cell references. This fixes the 
row, column or both so that they cannot be adjusted when 
copied. 


Transpose requires that the from range be a block or row. 
The to range can be either a cell, a row, or a column. Ifa 
column is being transposed into a row, an error message 
displays. 


When you copy cells from one spreadsheet to another, 
spreadsheet names and page numbers are not adjusted. 


See Special Considerations in /Load,Consolidate later in this 
chapter for consolidation guidelines. 
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/Delete 


Removes a row range, column range, block, or disk file. 
Confirmation is requested for file deletion. 


/Delete, — Row,row range 
Column,column range 
Block,block range (Up/Left) 
File, filename, (No/Yes) 
Page, page range 


You cannot reaccess rows, columns, or blocks containing data 
once you have deleted them, although if Undo is enabled you can 
use CtriH-Backspace immediately afterwards to restore the 
deleted material. 


Before issuing any command that could erase large amounts of 
data, such as /Delete, we recommend that you save your file first. 


With all /Delete options, formulas in the spreadsheet adjust when 
appropriate. 


/Delete,Row 


Removes the row range, then moves the adjacent rows to fill in 
the gap created. 


/Delete,Column 


Removes the column range, then moves the adjacent columns to 
fill in the gap created. 


/Delete, Block 


Removes the block range, with the option of moving the 
remaining data Up or Left: 


/Delete,Block,Up 


Moves data below the specified range up, to fill in the resulting 
gap. 
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/Delete,Block,Left 


Moves data beside the specified range leftward, to fill in the 
resulting gap. 


/Delete,File 


Deletes the file you specify from the current or specified 
drive/directory. You can press F3 to select from the File List. A 
prompt confirms your intention: 


No Does not delete the file. 
Yes Deletes the file. 


If this command occurs in a macro, the prompt will always be 
answered Yes. 


/Delete,Page 


Removes the page (or pages) you specify from the current 
spreadsheet, and renumbers the remaining pages. A prompt 
confirms your intentions: 


No Does not delete the page range. 

Yes Deletes the page range. 

Examples 

To delete row 5: /Delete,Row,5 Return 

To delete column E: /Delete,Column,E Return. 
To delete file WORK1.cal /Delete,File,B:WORK1.cal 
from drive B: Return Yes 


To delete rows 5 through 10: /Delete,Row,5:10 Return. 


To delete columns B to F: /Delete,Column,B:F Return. 
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Special Considerations 


1. Formulas that reference cells that no longer exist are 
considered an ERROR. See Chapter 3 for more information 
on ERROR. 


2. Ifa deleted row, column, or block contains a protected cell, 
an error message results and the row, column, or block will 


not be deleted. 


3. Absolute cell references (such as $A$1) are adjusted. 
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/Edit 


/Edit lets you change a cell’s contents, and place the revised data 
back in the original cell or another cell. The source cell can be 
within any spreadsheet in memory. The destination cell must be 
in the current spreadsheet. The default destination is the current 
cell. 


/Edit,source cell (extended) (edit into current cell 
P , destination cell 


/Edit copies the source cell contents to the entry line, where you 
can change it as you can any other data entry. You may specify 
any cell as the source cell. If you select /Edit and press Return 
without specifying a cell, the current cell becomes the source cell. 
The F2 key is a shortcut to editing the current cell. 


To specify a cell in another spreadsheet, use SuperCalc’s extended 
sheetname!cell notation. For example, to edit cell X4 of the 
spreadsheet SALES.cal, use /Edit, SALES/X4. 


/Edit Options 


After editing the cell contents, press Return to put the revised 
data into the current cell. 


You can edit a cell and place the revised entry in another cell. 
Choose /Edit, specify the cell to edit and type a comma (, ). 
Next, specify the target cell and press Return. After revising the 
cell contents on the entry line, press Return to place the data in 
the target cell. 


You cannot edit into a protected cell, but you can edit a protected 
source cell into an unprotected cell. 


You can point to both the source cell and destination cell. Use 
CtrHFPlus (+) and CtriHMinus (—) to point into other 
spreadsheets in memory. See Chapter 10 in the User’s Guide for 
an explanation of spreadsheet pointing. 
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Moving on the Entry Line 


Home moves the edit cursor to the beginning of the entry line; 
End moves it to the last character on the entry line. See Chapter 


1 for other editing keys. 


Examples 


Edit the current cell: 


Edit a specified cell into the 
current cell: 


Edit the contents of one cell 
into another cell: 


/Edit Return (revise) Return 


/Edit G7 Return (revise) Return 


/Edit B4,D11 Return (revise) 
Return 
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/Format 


/Format controls display of both the screen and printed output. 


The options change only the appearance of cells, not their values 
or contents. 


/Format, — Global , ~ Accept 


Column,column range Integer 
Row, A row range General 
Remaining (>254) Exponential 
Entry, range $ 
Right 
Left 
Center 


Text, (Left/Right/Center) 
* 
User-defined, C Number (1-8) 
Date,(1-8) 
Hide 
Default 
Width, column width 
(Global and Column only) 
User-define, — Number, r Quit 
1 , r Quit 
Before,(Default/None/Enter,string) 
After,(Default/None/Enter,string) 
Thousands,(Yes/No) 
Minus,(Yes/No/Float) 
Percent(Yes/No) 
Decimal,(O-7) 
Zero,(Yes/No) 
Zap Scaling,(O-7) 
Date, Quit 
1 date/time format string 
2 date/time format string 
3 date/time format string 
4 date/time format string 
5 date/time format string 
6, date/time format string 
7 date/time format string 
8 date/time format string 
T date/time format string 
Zap 
Hide-column,column range (Yes/No) 


CHA Wh Q NW 
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/Format sets display formats that: 


NH Define how numbers appear: integers, decimals, exponents, 
currency, or asterisk rows. 


m Display values and text in the right, left, or center of a cell. 


E Determine the appearance of dates and times. 


NW Set column width. 


m Prevent unauthorized viewing of confidential information by 
hiding cells or entire columns. 


There are four types of options available through /Format: 


Format 
Levels 


Format 
Options 


User-define 
Options 


Column- 
Hiding 
Option 


Determine whether formats are applied 
globally to the entire spreadsheet, or to 
selected columns, rows, and cells. 


Specify which formats are applied at the 
selected level. => 


The format options are subordinate to the 
level options. Except for Width, available 
only at the Global and Column level, each 
format option is available for every level. 


Define custom format sets, to apply to areas 
of your spreadsheet. 


Make selected columns inaccessible; users 
can't view or move the cursor to these 
columns. 


First, select the appropriate level (global, row, column, or entry 

level), then choose which formats apply. Use the column-hiding 

option at any time; hiding columns doesn’t change formats 

applied to those columns. Pog 
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Format Levels 
When you select /Format, these options display: Global, Column, 
Row, Entry, User-define, and Hide-column. 


The first four set the format level and display the format options. 


When select a format level, remember that Column formatting 
overrides Global, Row overrides both Column and Global, and 
Entry overrides all other formatting. 


For more discussion of the hierarchy of these format levels, and 
instructions for viewing current format settings, see Chapter 7 of 
the User’s Guide. 


/Format,Global 


Applies selected format option(s) to the entire spreadsheet. 


/Format,Column 


Applies selected format option(s) to the specified column range. 
Column-level formats override formats set at the Global level. For 
example, suppose you set a Global format of General (numbers 
display as best fit), then apply the $ format (2-digit decimal) to 
column C. Column C will display numbers as currency, while 
they appear elsewhere as best they fit. 


/Format,Row 


Applies selected format option(s) to the specified row range, any 
row(s) between 1 and 254. Row level formats override formats 
set at the Column and Global level. 


If you need to apply formats at the Row level to row numbers 
greater than 254, use /Format,Row,Remaining. The same set of 
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format options is applied to all remaining rows — 255 through 
the last row. For example: 


/Format,Row,Remaining,$,Accept 


displays all existing and future entries in row 255 through the last 
row as currency. 


To assign different formats to individual rows past 254, use 
/Format,Entry. 


/Format,Entry 


Applies selected format option(s) to specified cells and cell 
ranges. Entry-level formats override Row, Column, and Global 
formats. 


Format Options 


Once you select a level option and specify the area to be 
formatted, these format options display: Accept, Integer, General, 
Exponential, $, Right, Left, Center, Text, *, User-defined, Hide, 
Default, and Width. 


There are three types of format options you can apply to numeric 
data at each level. You can apply one option of each type to a 
given cell at the same time: 


Numeric Integer, General, Exponential, $, * User- 
defined Number. 

Alignment Right, Left, and Center. 

Cell-Hiding Hide. 


Width can be applied with numeric and text formats at the Global 
and Column level. 


/Format,Accept 


Applies all selected formats to the specified range. 
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/Format,Integer 


Displays numbers as integers, rounding as necessary to produce 
whole numbers. No decimals are displayed. 


/Format,General 


Displays numbers as an integer if the number is an integral value, 
or in decimal format with as many places as the column width 
allows. Numbers larger than the column width display in 
exponential format. 


/Format,Exponential 


Displays numbers in exponential form using conventional 
scientific notation. Numbers are expressed as a power of ten 
containing one significant figure to the left of the decimal point. 
The letter e separates the number from the order of magnitude; 
1776 is written as 1.776e3. 


For example, to format block A7:H8 in exponential notation, 
enter: 


/Format,Entry,A7:H8,Exponential,Accept 


/Format,$ 


Indicates the number is currency; displays numbers with two 
digits after the decimal point. The character $ is not displayed. 
To display a currency symbol, use /Format, User-defined, Number. 
You can select a currency symbol other than the default with 
/Format, User-define. 


For example, to globally format the spreadsheet for currency, and 
an 11-character column width, enter: 


/Format,Global,$,Width,11,Accept 
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/Format,Right 


Aligns numbers, dates, and times at the right side of the column. 
This is the default justification for numeric data: 


986 
5098 
94667 
/Format,Left 


Aligns numbers, dates, and times at the left side of the column: 


986 

5098 

94667 
/Format,Center 


Centers numbers, dates, and times within columns: 


986 
5098 
94667 


/Format,Text 


Controls the position of text in the cell and offers the following 
options: 


Right Justifies text entries to the right. 
Left Justifies text entries to the left. 
Center Positions text in the center of the cell. If the 


text cannot be centered, the text shifts one 
space to the right. For example, a five-letter 
word in a six-character column, or a six-letter 
word in a seven-character column would shift 
to the right. 


For example, to format rows 7 to 12 to be right-justified text, 
enter: 


/Format,Row,7:12,TextRight,Accept 
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/Format,* 


Represents positive integers as asterisks (*); decimals are rounded. 
Use this format to create a simple graphic representation of a 
range of values. For example, the number 1 is displayed as one 
asterisk (*), the number 5 as five asterisks (*****). 


/Format,User-defined 


Applies custom number, date, and time formats. 


Number Displays numbers in one of eight formats 
(1-8) created with /Format, User-define, Number. 
Date (1-8) Displays dates and times in one of eight 


custom formats created with /Format, User- 
define,Date. You can define a ninth format, 
T, which is the program default for times. 
However, this format cannot be applied to 
individual cells, but is used for time values 
that cannot be displayed by the data format in 
effect for that cell. 


/Format,Hide 


Hides cell contents. The cell value does not display on screen 
nor print, although the contents appear on the status line when 
the cursor is placed on a hidden cell. The cursor ignores hidden 
cells when Tab—Arrow and Backtab—Arrow are used. Right— , 
Left-, Up—, and Down—Arrows and F5 (GoTo) will access 
hidden cells. 


Hiding doesn’t affect the content or format of cells directly. 
However, cells can only be redisplayed using /Format, Default at 
the same level as you hid the column. At that time, their formats 
revert to the default setting, but contents remain unchanged. 


You can use /Format,Hide-column as an alternative when hiding 
entire columns. The cursor won’t stop on hidden columns and 
their values don’t display on the status line. Applied formats are 
not lost when you “unhide” these columns. 
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/Format,Default 


Removes previously set format options at the specified level. At 
the Global level, Default returns the display format to the 
following initial settings: 


General numeric format 

User-defined Number format 1 for dates 
User-defined Date format T for times 
Left text alignment 


kight numeric alignment 


Column Width 9 


/Format, Width 


Sets the column width to the designated number (0-127). 
Selecting Width changes the program mode to POINT so that you 
can use the right or left arrow keys to adjust the column width. 
The column width changes as you point. 


You can also enter a number (0 to 127) to set the column width. 
When you begin typing a number, you change the program to 
EDIT mode. Column width can be set for Global and Column 
level formats only. 


You can set a column width to 0 to hide the column and hide the 
cursor. It’s simpler to use /Format, Hide-column. 


User-Define Options 


Let you define numeric, date, and time formats for application to 
cells at any of the four levels. When you select User-define, these 
options display: Number and Date. Date covers both dates and 
times. Select one according to the type of format you need to 
define. 
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/Format,User-define, Number 


Lets you define up to eight numeric formats, including foreign 
currency symbols and punctuation. Selecting Number displays 
the User-Define Number Format Menu: 


USER-DEF INE NUMBER FORMAT MENU 


Currently Defined Format ¿ero as Scaling 
Blank Factor 
1,111,111,11 


5-1 

6-4 413,411.11 

( aerate 
( §11,111,111.11) 
$-11111111 
11,111,111 
(ELIO 
1111111111, 112 


P1*A1 
Before After Thousands Minus Percent Decimal Zero Scaling 
30>/Fornat, User—def ine, Number ,4, 
MENU Return to “Fornat menu 


m Items that have been modified from the program defaults are 
displayed in high intensity. 


m Menu settings can be saved for future use with /Global, Keep. 
See Saving and Keeping User-define Formats, \ater in this 


section. 


NW The menu is divided into eight rows, called Format Sets, 
indicating the currently defined number formats. 


m A Format Set can be redefined at this menu. To actually 
apply the format you use: 


/Format, (level), User-defined, Number# 


where level is Global, Column, Row, or Entry (and a range, 
where required), and # is any Format Set number, 1-8. 
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æ Thousands, decimal, and operand separator symbols (such as 
, .;J, can be redefined using /Global, Optimum, Present, 
Punctuation. 


The /Format, User-define, Number menu displays these options: 
Quit, 1, 2, 3, 4, 5, 6, 7, 8, Zap: 


/Format, User-define, Number, Quit 


Returns the program to the main /Format menu. 


/Format, User-define, Number, Zap 


Restores all formats to the current program defaults — the last 
ones saved with /Global, Keep. 


/Format, User-define, Number, 1-8 


Lets you redefine the selected Format Set. When you select a 
number, 1 through 8, these options display: Quit, Before, After, 
Thousands, Minus, Percent, Decimal, Zero, Scaling. 


Quit Returns you to the main /Format menu. 

Before Precedes (follows) numeric values with the 

(After) specified currency string. You have three 
options: 


a Default — Uses the Before (After) 
string as defined at the Optimum 
Spreadsheet Conditions Menu using 
/Global, Optimum, Present. 


g None — Deletes the Before (After) 
string for this Format Set. 
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a Enter — Allows you to define a 
specific string — up to 15 characters — 
unique to each number format. As 
shipped, each of the eight number 
formats has a string already defined 
(possibly an empty string). For 
example, if you enter a Before string as 
CRS, the number 99 displays as CR$99 
when formatted with the Format Set. 


A space entry (Spacebar) displays as a 
low intensity underscore () on the 
Number Format menu, but as a blank 
on the spreadsheet. 


Thousands Determines whether thousands separators 
appear in numbers. The characters used as 
thousands, decimal, and operand separators 
are defined with /Global, Optimum, Present, 
Punctuation. 


E Yes — Inserts a thousands separator 
between every third place to the left of 
the decimal. For example, assuming 
the thousands separator is a comma: 


PIII. 
ES No — Does not insert a thousands 
separator. 

Minus Determines whether negative values will be 
preceded by a minus sign (-) or enclosed in 
parentheses. 

g Yes — Encloses negative values within 


fixed parentheses, as wide as the 
column: ( 99). Positive numbers shift 
one place to the left to align the 
decimal point with negative numbers in 
the same column. 
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Percent 


Decimal 


Zero 


E No — Inserts a minus sign before a 
negative value: -99. 


L Float — Encloses negative numbers in 
parentheses, with no space between 
the number and the parentheses. The 
parentheses are positioned according to 
the number of digits in the value 
instead of the width of the column: 
(99). Select Yes to cancel floating after 
selecting float. 


On some monitors negative numbers also 
display in red. 


Determines whether the number will be 
treated as a percentage or not. 


E Yes — Multiplies a numeric value by 
100 and appends a percent sign (%). 


2% No — Does not show numeric values 
as percentages. 


Specifies the number of decimal places in a 
number, from Oto 7. Internally, SuperCalc 
continues to work with 16 decimal places. 
Setting this value to 2 has the same effect as 
the /Format, $ option. 


Determines whether zeros will appear as 0 or 
a blank space. 


= Yes — Displays a blank space if the 
numeric value of the cell is zero. 


E No — Displays a zero if the numeric 
value of the cell is zero. 
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Scaling Specifies the power of ten by which the 
number displayed is scaled down, Oto 7. For 
example, a scaling factor of 3 displays 9000 as 
9 (the displayed value is divided by 1000). 


/Format,User-define,Date 


Lets you define up to nine time and date formats, including 7, the 
program time default. Format Set 7 is the Date default. Selecting 
Date displays the User-Define Date Format Menu: 


USER-DEFINE DATE FORMAT MENU 


Fornat Example (using March 8, 1988 9:18:38 AM) 
_BM/BD+-YY YY 3/ 6/1988 

DD-MMM-YY 88-Mar-88 

DD-MMM B8-Mar 

MMM-YY Mar-—80 

MM/DD/YY 83-68788 

MM/DD 03-88 

YY-MM-DD 88-83-88 

DD. MM. YY 68.83.88 

BH: TT: SS_AM-PN 9:18:38 AN 


Use M, BM, MM, MMM, MMMM or R for month 

Use D, BD, DD, for day 

Use Y, YY, YY YY for year 
Use HH, BH for hour 
Use TT, BT for ninute 
Use 55, BS for second 
Use AP, arp, AM/PM, an/pn for clock 


mP1*A1 

| 1 2 3-816 6-7 9:71 Zap 
26>/Fornat, User—-def ine, Date; 
MENU Return to “Format menu 


m SuperCalc considers dates and times to be based on a single 
date-time data type. Dates display when the value of date- 
time is equal to or greater than 1; time displays when date- 
time is less than one. 


E Menu items that have been modified from the program 
defaults are displayed in high intensity. 


m YYYY defaults to YY if the width of the cell does not permit a 
full display. For example, 1988 becomes 88. 
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m Settings at the User-Define Date Format Menu can be saved 
with /Global,Keep. See Saving and Keeping User-define 
Formats, later in this chapter. 


m Any of the date Format Sets can be redefined at this menu, 
with up to 28 characters. To actually apply the format, use: 


/Format, (level), User-defined, Date, # 


where level is Global, Column, Row, or Entry (and a range, 
where required), and # is any Format Set number, 1-8. 


The User-Define Date Format Menu displays these options: Quil, 
1, 2, 3, 4, 5, 6, 7, &, L and Zap. 


/Format, User-define, Date, Quit 


Returns the program to the main /Format menu. 


/Format, User-define, Date, 1-8 and T 


Lets you redefine the selected Format Set. When you select 
options 1 through 8 or T, the current string for the associated 
format moves to the entry line. For example, if Format Set 5 is 
MM/DD/YY, when you select 5 the dialog panel displays: 


+ TEMP1!A1 i 
Press F2 to edit, any other character to start fresh, 


28>/Format User—def ine, Date, 5,MN/DD- YY 
MENU Edit date string 


m To indicate the day, month, year, hour, minute, second, and 
clock formats within date and time format strings, use the 
special tokens described later in this section. 


m Tokens can be preceded or followed by literal text strings, 
such as June. 
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m The first time a token appears in a string it is referenced as a 
token and converted into the appropriate date or time value. 
However, subsequent occurrences of the token within the 
same string are not referenced as date tokens, they are just 
ordinary text. For example, the date format string 
MM/MM/YY displays this for July 29, 1988: 07/MM/88. 


If you want to use a token character as text in a format string, 
you must enclose it in double quotes. For example, the date 
format Date = DD/MM/YY displays the date for January 9, 
1986 as Yate = DD/01/86 because the uppercase D in Date is 
interpreted as a token. Furthermore, the DD is not 
interpreted as a token because the day format has already 
been specified. To format this example properly, use "D'ate= 


DD/MM/YY. 
Day Tokens Tokens meaning day display as follows: 
sE D — One or two digits with no leading 
zeros or blanks. 
a DD — Two digits with a leading zero 
when appropriate. 
a BD — One or two digits with a leading 
blank when appropriate. 
# WWW — Abbreviated day of the week 
(Monday displays as Mon). 
z WWWW — Day of the week (Monday 
displays as Monday). 
Month Tokens meaning month display as follows: 
Tokens 
Ñ M — One or two digits with no leading 
zeros or blanks. 
e MM — Two digits with a leading zero 


when appropriate. 
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Year Tokens 


BM — One or two digits with a leading 
blank when appropriate. 


MMM — A three-character alphabetic 
abbreviation (for example, Jan, Feb....). 


MMMM — Fully spelled out: January, 
February... 


R — Roman numerals: January = I, 
February = II, and so on. 


Tokens meaning year displayed as follows: 


Y — Years having two final digits with 
a value less than 10, such as 2001 or 
2009, are displayed as one digit. Other 
years are displayed as two digits. 


YY — Two digits with a leading zero 
when appropriate. 


YYYY — Four digits, or two digits if 
the cell width does not permit a full 
display. 


/Format, User-define, Date, Zap 


Restores all date formats to the current program defaults — the 
last ones saved with /Global, Keep. 


Examples 


Examples of date formats using January 9, 1986 and October 31, 


2005: 


FORMAT 


MM/DD/YY 
BD-BM-YYYY 
M.D.Y 
DDMMMYY 


JANUARY 9, 1986 OCTOBER 31, 2005 
01/09/86 10/31/05 

9- 1-1986 31-10-2005 

1.9.86 10.31.5 

09Jan86 310ct05 
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MMMM D,YYYY January 9,1986 October 31,2005 

"D"ate = DD/MM/YY Date = 09/01/86 Date = 31/10/05 

Time Tokens Time tokens for hours, minutes, and seconds 
are: 


E HH — Hours are displayed as two 
digits with a leading zero when 
appropriate. 


E BH — Hours are displayed as one or 
two digits with a leading blank when 
appropriate. 


e TT — Minutes are displayed as two 
digits with a leading zero when 
appropriate. 


3 BT — Minutes are displayed as one or 
two digits with a leading blank when 
appropriate. 


E SS — Seconds are displayed as two 
digits with a leading zero when 
appropriate. 


e BS — Seconds are displayed as one or 
two digits with a leading blank when 
appropriate. 


Clock AM and PM can be shown four ways when 
Tokens /Global, Optimum, Present, Time is set to 12hr 
A/P, a/p, AM/PM, am/pm. 


For example, BH:TT:SS_AM/PM is the default time format. If 
hours = 2 in the afternoon, minutes = 6, and seconds = 15, the 
default time display is 2:06:15 PM with Time set to 12br. 


Saving and Keeping User-define Formats 
User-Define formats from both the User-Define Numberand Date 


Format menus are saved with the spreadsheet. Those values that 
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have been changed from the Keep values (the last values kept 
with /Global, Keep) are highlighted. There are two ways that a 
value can be changed from the Keep value: (1) You can 
explicitly change it or (2) you can load a spreadsheet where it 
was defined explicitly. 


Highlighted values are saved with the spreadsheet. Non- 
highlighted values are not saved explicitly. This means that for 
non-highlighted values, if you save a spreadsheet, and later 
change the Keep setting, when you load the spreadsheet, the new 
Keep value will be in effect. Thus, if you want to save a value 
with the spreadsheet, you must define it, even if it has the same 
value as the Keep value. 


Clearing a spreadsheet with /Zap, Yes resets user-defined formats 
to their default state. 


/Format,HideColumn 


Hides an entire column or column range. After you select 
/Format,HideColumn, the entire spreadsheet displays. Any 
hidden columns show an asterisk (*) next to the column letters. 
You are prompted to enter a column range and choose between 
two options: Yes and No. 


Yes The specified column or range, including 
column letters, disappears from the screen. 
Neither the data in the column nor the 
formatting options for the columns are 
altered. To restore the column, specify 
/Format, HideColumn again and select No. 


No The specified column or range is not hidden; 


redisplays a specified range of hidden 
columns. 
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/Global 


/Global sets program defaults, including installation of basic 
spreadsheet and graphics printers and plotters. You can select 
specialized graphics ouput devices with //Graphics, Global, Drivers, 
discussed later in this chapter. 


/Global, — Optimum, Present, > Punctuation,(1-8) 

Before, E None 

Enter, string 
After, x None 

Enter,string) 
Time,(12hr/24hr) 
Minimal,(Auto/Yes/No) 
Interruptible,(Yes/No) 
Undo,(Yes/No) 
Extension,(CAL/wk1/wkS) 
Regraph,(Auto/Manual) 
Flash,(Yes/No) 
LICS,(Yes/No) 
Quit 

Next, Memory,(Fast/Data-space) 
Boundary,(Auto/Small/Medium/Large) 
Expanded, pes 
Part,memory to use: 
0-32768kb 

Video, (IBM/Compaq/Hercules) 
Attribute,(Auto/Color/Black/White) 
Graphics,(Yes/No) 
Dual (Yes/No) 


Quit 
Quit 
Keep, Yes 
No If name found: 
To, filename y Backup 
i Change 
Overwrite 


Spreadsheet,All 

Graphics, m All 
Colors 
Globals 
Others 
Text 


From, filename, L All 


SuperCalc Commands 2-67 


/Global 


Graphics, Quit 
Device, - B&W-printers, point to device name 
(Ce) to select) 
Color-printers, point to device name 
(C€) to select) 
Plotters, point to device name 
(C€) to select) 
Layout,(graph size/position) 
Options, - Parallel, — 1=LPT1: 
- ZEP TZ 
S= LPTS: 
Serial, Com#, — 1 = COMI: 
2 COR: 
3=COM3: 
4 = COM4: 
Baud, -1=110 
2=150 
3 = 300 
4 = 600 
5 = 1200 
6 = 2400 
7 = 4800 
8 = 9600 
9 = 19200 
Parity, — Odd 
- Even 
None 


Data-bits,(7/8) 
Stop-bits,(1/2) 
DOS 
Check,(Yes/No) 
Auto 
Zap 
Quit 
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Quit 
Cartridges, > 1 
2 
3 
Softfonts,(1/2/3/Quit) 
Quit 
Device, - B&W-printers, point to device name | 
i (C2) to select) | 
Color-printers,point to device name 
(C) to select) > 
Fonts, Default , - Face 
1 Point-size 
2 Bold, (Yes/No) 
3 Italic,(Yes/No) 
4 Quit 
5 
6 
T 
Quit 
Options, — Parallel, — 1 = LPT1: 
- 2 =LPT2: 
IE PPS 
Serial, Com#, — 1 = COM1: 
2 =COM2: 
3 =COM3: 
4 = COM4: 
Baud, -1=110 
2=150 
3 = 300 
4 = 600 
5 = 1200 
6 = 2400 
7 = 4800 
8 = 9600 
9 = 19200 
Parity,(Odd/Even/None) 
Data-bits,(7/8) 
Stop-bits,(1/2) 
DOS 
Check,(Yes/No) 
Auto 
Formfeed,(Yes/No) 
Zap 
Quit 


Translation-tables ((€@) to select) 
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Evaluation, Quit 
Order,(Dependent/Row/Column) 
When,(Manual/Auto) 
Iteration-control, Solve,(Quit/Delta/Range) 
Fixed, iteration count: 1-99 
Range,range (“-” to clear) 
Values 
1-2-3 
+ (Formula/” /Labels/Protection/Border/Next/Tab/Unprotected/Zoom) 
— (Formula/” /Labels/Protection/Border/Next/Tab/Unprotected/Zoom) 
Formula 
n 
Labels 
Protection 
Border 
Next 
Tab 
Unprotected 
Zoom 


/Global options let you: 

Change format and display characteristics. 
Modify output and performance. 

Save changed defaults. 

Change hardware settings. 


Alter the spreadsheet calculation order. 


View spreadsheet settings. 
When you enter /Global, these options display: Optimum, Keep, 


Graphics, Spreadsheet, Evaluation, Values, 1-2-3, +, -, Formula, ”, 
Labels, Protection, Border, Next, Tab, Unprotected, Zoom. 
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Optimum and Spreadsheet let you access additional selection 
menus (sometimes referred to as default menus). Keep retains 
any changes made at these menus as program defaults. The 
defaults are saved in configuration files. There can be as many 
configuration files as you need (see /Global, Keep, later in this 
section). 


Keep also retains as program defaults the current /Output, Options, 
/Format, Global level and User-define settings, /Global settings 
(except Tab), //Add-in settings, and SuperCalc data drive and 
directory settings at the File List. 


3 
Q. 
m 


Evaluation determines recalculation order and when recalulations 
occur. Values displays program default settings. 1-2-3 sets the 
program to interpret Lotus 1-2-3 command sequences as 
SuperCalc commands. 


The second group of options, beginning with Formula, consists of 
on/off toggles. The current settings for the options are 
highlighted on your screen. Highlighting indicates the toggle is 
on and the option is activated. If you change a setting, the 
highlighting reflects that change, and the change is saved with the 
spreadsheet. Select + or - followed by a toggle option to ensure 
that the toggle is either on or off, respectively, regardless of its 
previous setting. 


All /Global options are described below. 


/Global, Optimum 


Accesses two menus containing default values. The default values 
in the Present menu affect the current session or future sessions, 
while the default values in the Next menu affect only future 
Sessions. 


Values changed for future sessions take effect after using 
/Global,Keep and /Quit, then starting a new SuperCalc session. To 
quit and restart with one command sequence, use /Quit, To,SC5. 
Remember to save your spreadsheet before using /Quit. 
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/Global,Optimum,Present 


Displays the Optimum Spreadsheet Conditions Menu (current 
session) with these options: Punctuation, Before, After, Time, 
Minimal, Interruptible, Undo, Extension, Regraph, Flash, LICS, 
and Quit. 


The menu defines the default values for the current session. 
These values can be kept for future sessions with /Global, Keep. 


/Global, Optimum, Present, Punctuation 


Specifies a set of numeric separator characters. The operand 
separator separates arguments in functions: 


Decimal Operand Thousands 

1. i , 

2 ) 

ri ; ; 

4, , ; 

5. , space 

6. ; space 

gii i space 

8. ' space 


In most cases, the appropriate punctuation for each country 
(based on standard usage) is pre-set as the default. 


Changes in Punctuation have a direct effect on any macro 
command or formula containing punctuation separators. For 
example: 


If operand = . use IF(cond.x.y) 
If operand = ; use IF(cond;x;y) 


2-72 SuperCalc Reference Manual 


/Global 


/Global, Optimum, Present, Before and After 


Define the default strings appearing Before or After currency 
values for /Format, User-define, Number. 


None Removes the existing currency string, if any. 


Enter Lets you change the currency string. To enter 
an ASCII character such as the pound sterling 
or yen sign, enter the ASCII decimal 
equivalent for the appropriate character on 
the numeric keypad while pressing the Alt 
key. See Appendix J for ASCII decimal 
equivalents. 


/Global, Optimum, Present, Time 


Sets time values to display on a 12- or 24-hour basis. Time 
formats are defined with /Format, User-define, Date and are applied 
to cells with /Format,, User-defined, Date. 


/Global, Optimum, Present, Minimal 


Auto The initial default; SuperCalc determines 
whether to calculate the entire spreadsheet or 
only cells that are dependent on the cell just 
added or edited. If formulas are being 
modified, Minimal is suppressed. 


Yes During recalculation, only recalculates cells 
that are dependent on the cell just added or 
edited. This option may save recalculation 
time, but requires more random access 
memory (RAM). 


No Recalculates all spreadsheet cells. Leaves you 
more random access memory. 
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/Global, Optimum, Present, Interruptible 


Yes Entry of new data will interrupt recalculation. 
Recalculation will resume when Return is 
pressed to terminate data entry. 


No During recalculation, new data cannot be 
entered until recalculation is complete. 


/Global, Optimum, Present, Undo 


Yes Activates SuperCalc’s Undo feature. Then, 
you can reverse most commands and data 
entries that change the spreadsheet (/Copy, 
/Move, /Insert, and so on). Use 
Ctrl-Backspace to take back the previous 
command or entry. Pressing CtrHBackspace 
again returns the spreadsheet to its original 
condition. Because a second copy of the 
spreadsheet must be maintained in memory, 
this function reduces the amount of available 
memory by about half. 


No Disables the Undo feature, freeing additional 
memory. 


Once enabled, Undo does not take effect until all spreadsheets 
have been cleared with /Zap or //Spreadsheets, Zap or by restarting 
SuperCalc. 


You cannot undo the effects of cursor control keys. Functions 
that operate outside of SuperCalc in conjunction with the 
operating system, such as file manipulation functions (Output, Go, 
/Save, and so on) cannot be undone. These functions are: 
/Global, Optimum, /Global, Keep, /Output,Go, /Quit, /Save, //Export, 
//Macro, Write, //Network, //Spreadsheets, Save, and 

//Spreadsheets, Quit. 
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/Global, Optimum, Present, Extension 


Specifies the default extension to use in FILE mode: 


.CAL Saves .cal files. 
.wki Saves Lotus 1-2-3 Release 2 files. 
.Wks Saves Lotus 1-2-3 Release 1A files. 


Extension only affects /Save when no file extension is specified. 
/Load always looks for any of the three extensions. 


/Global, Optimum, Present, Regraph 


Auto Redraws the current chart on your secondary 
(color) monitor automatically after each 
spreadsheet recalculation if you are using a 
dual monitor setup. 


Manual Only redraws the current chart on your 
secondary monitor when you press F10. 
Spreadsheet operations are faster because 
graphs are redrawn less frequently. 


/Global, Optimum, Present, Flash 


Yes Provides an alternate screen color set for use 
with memory-resident programs that reset the 
video display. Use this option if the 
SuperCalc borders blink or flash during use. 


No The initial default; uses the standard 
SuperCalc screen color set. 
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/Global, Optimum, Present, LICS 


Yes The initial default; translates the Lotus 
International Character Set to or from 
corresponding ASCII extended characters 
when you directly load or save Lotus 1-2-3 
Release 2 files. Exact translation is not 
available in ASCII for some LICS characters. 
These characters are translated without accent 
marks or as a blank. (See Appendix J for a 
table of ASCII characters.) 


No Does not translate the Lotus International 
Character Set. 


/Global, Optimum, Present, Quit 


Returns you to READY mode. 


/Global,Optimum,Next 


Lets you set default values for future sessions. Changed values 
take effect when you use /Global, Keep and then start a new 
SuperCalc session. Remember to save your spreadsheet before 
quitting. Selecting Next displays the Optimum Spreadsheet 
Conditions Menu for future sessions. It offers these options: 
Memory, Boundary, Expanded, Video, Attribute, Graphics, Dual, 


Quit. 


/Global, Optimum, Next, Memory 
Fast The initial default; improves performance; 


leaves less memory for spreadsheet data. 


Data-space Allocates any extra memory space for 
spreadsheet data. This may slow down some 
command selections and calculations. 
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/Global, Optimum, Next, Boundary 


You can increase data-space by selecting a smaller spreadsheet 
size, if your spreadsheet allows the boundary reduction. 


Auto The initial default; selects the spreadsheet size 
appropriate for the memory in your computer. 


Small Sets the spreadsheet size to 63 columns 
(column BK) by 254 rows. 


Medium Sets the spreadsheet size to 127 columns 
(DW) by 2000 rows. Uses slightly more 
memory than Small. 


Large Sets the spreadsheet size to 255 columns (IU) 
by 9999 rows. Uses more memory than 
Medium. 


A row or column containing data occupies more data-space in 
memory than an empty row or column. To construct a 
spreadsheet using the least amount of memory, use only the 
necessary rows or columns. They need not be contiguous. 


You cannot load a spreadsheet file that contains data in cells 
beyond the current spreadsheet boundary setting. 


/Global, Optimum, Next, Expanded 


All The initial default; expands the available 
memory to the size of your expanded 
memory board (less the amount required by 
the board’s own utility). 


Part Lets you allocate up to 32 megabytes (in 


kilobytes, 0 to 32768) of memory to your 
spreadsheet . 
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/Global, Optimum, Next, Video 


IBM 


Compaq 


Hercules 


The initial default; sets display characteristics 
for an IBM Personal Computer, and most IBM 
compatibles. 


Sets display characteristics for Compaq 
computers. 


Sets display characteristics for computers with 
a Hercules or compatible graphics card. 


/Global, Optimum, Next, Attribute 


Auto 


Color 


The initial default; lets the program determine 
what attributes to use. This is the setting for 
most computer systems, including those with 
standard (RGB) color monitors and 
monochrome graphics monitors. The 
monochrome graphics monitors convert RGB 
color into various intensities. 


Forces SuperCalc to use a color palette for 
spreadsheet and graphics display. 


Use this setting if SuperCalc displays black- 
and-white on a color monitor. This may 
happen with some displays, including IBM 
8514/A. 
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The setting for a Compag (or Compaq- 
compatible) computer with a monochrome 
monitor, or any computer with a composite 
color monitor, such as a television set. 
Black/White forces SuperCalc to use a black- 
and-white attribute set for spreadsheet and 
graphics display. 


If you change the Attribute default to 
Black/White and save it using /Global, Keep, 
you no longer need to start the program with 
the special SC5/BW command. Instead, use 
SC5. 


/Global, Optimum, Next, Graphics 


Yes 


Loads SuperCalc graphics program files into 
memory, activating the //Graphics menu. 


Saves memory by not loading graphics 
program files. /View and //Grapbics will not 
work. 


/Global, Optimum, Next, Dual 


Yes 


The default setting; with two monitors 
attached, SuperCalc displays spreadsheets on 
the primary monitor, and charts on the 
secondary monitor if it is connected to a 
eraphics adapter card. 


Displays spreadsheets and graphics alternately 


on the primary, or only, monitor. 
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/Global,Keep 
Yes 


To 


From 


Saves the current default settings in file 
SC5.cfg (the startup configuration file) with 
add-in settings in ADN.cfg. 


Returns to the spreadsheet without saving 
default settings. 


Saves the current configuration in the file you 
specify. You can use the full DOS path 
convention. For example, you can save the 
configuration as: 


dE SC5.cfg in a directory other than the 
current logged directory. When you 
start a SuperCalc session from that 
(logged) directory the new 
configuration is read automatically. 


x Any file in the current dogged) 
directory or other directory. When you 
start a SuperCalc session from this al 
directory you can specify the new 
configuration file as a parameter on the 
DOS command line. For details, see 
Chapter 1. 


Loads a set of program defaults from a 
specified configuration file; the current 
settings are lost. Pressing F3 displays a 
directory of .cfg files. Any defaults set with 
/Global, Optimum, Next and //Add-in are not 
reset, but will affect any configuration files 
kept. 


After specifying the configuration file to use, 
these options display: All, Spreadsheet, and 
Graphics: SS 
a All — Uses both spreadsheet and 

graphics settings in the file. 
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= Spreadsheet,All — Uses all 
spreadsheet settings but keeps the 
current graphics settings in effect. 


ig Graphics — Uses the current 
spreadsheet settings, but uses graphics 
settings from the specified file: AU uses 
all graphics settings; Colors uses only 
color settings, but not fonts or other 
text settings, or any other graphics 
settings; Globals uses //Graphics, Global 
settings; Others uses only graphics 
settings besides colors, globals, and 
text; and Textuses only the graphics 
settings relating to text. For more 
information on specific settings used 
with each option, see //Grapbics, later 
in this chapter. 


/Global, Keep does not save spreadsheets or charts. Be sure to 
save them with /Save before using /Zap,/Quit, or 
//Spreadsheets, Zap or Quit. 


See Chapter 1 for instructions on specifying a configuration file 
with the startup command. Then, you can start the program with 
the default settings of your choice. 


/Global, Graphics 


Provides a set of hardware and layout options on three menus: 
Device Selection, Layout, and Options. When you select /Global, 
these options display: Quit, Device, Layout, and Options. 


/Global,Graphics,Quit 
Returns SuperCalc to READY mode. 
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/Global,Graphics,Device 


Displays the Device Selection Menu, which is used to install your 
graphics printer or plotter for chart output. Use /Global, 
Spreadsheet, Device to install a character printer for spreadsheet 
reports. 


Installing a graphics printer or plotter is a one-time program setup 
procedure. Repeat graphics device selection only if you change 
your printer. To make your device selection the program default 
for all work sessions, use /Global, Keep as described earlier in this 
section. 


If your printer is not listed, refer to the printer manual to see if 
your device emulates or is compatible with one of the devices 
listed. 


Besides the output devices available through /Global, Graphics, 
Device, you can select drivers for special purposes including slide 
production and camera input. You can also output to PIC and 
CGM files. For information on these special graphics output 
options, see //Graphics, Global, Drivers later in this chapter. 


/Global, Graphics, Device, BE W-printers 


Displays a printer selection menu. To select your printer, use the 
Arrow keys to highlight its name or manufacturer and press 
Return. 


/Global, Graphics, Device, Color-printers 


Displays a color printer selection menu. To select your printer, 
use the Arrow keys to highlight its name or manufacturer and 
press Return. 


/Global, Graphics, Device, Plotters 


Displays a plotter selection menu. Use the arrow keys to 
highlight your plotter’s name or manufacturer and press Return. 
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/Global,Graphics,Layout 


Displays the Layout Menu, containing settings for the page layout 
of your plotted chart. The options are: Page Size (Paper, Width, 
and Length), Chart Size (Mode, Rotation, Width, and Length), and 
Chart/Page Offset (Top, and Left). 


A description of each option is displayed on the Layout Menu. 
Widths and Lengths are set automatically when you select your 


graphics output device. By changing Mode to Manual, you can 
alter size, rotation, and offset settings. 


/Global, Graphics, Layout, Mode 
Mode has the following options: 


Full The default setting; plots the chart on an 
entire page. 


Manual Lets you change page or chart Size, Rotation, 
and Offset settings. 


Top Draws the chart on the top half of the page. 

Bottom Draws the chart on the bottom half of the 
page. 

1-4 Draws the chart in the quadrant you select. 


The quadrant positions, in either paper 
rotation, are 7 = upper-left, 2 = upper-right, 3 
= lower-left, 4 = lower-right. 


/Global, Graphics, Layout, Rotation 


Lets you print or plot a chart either horizontally or vertically. 
SuperCalc scales the chart, making use of the full allowed page 
according to the Mode setting. 
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/Global,Graphics,Options 


Displays the Options Menu containing a list of output interface 
settings for communicating with printers, plotters, and modems. 
You can select from these options: Auto, Parallel, Serial, DOS, 
Check, Zap, and Quit. has 


/Global, Graphics, Options, Auto 


Selects device settings based on the manufacturer’s 
recommendations. This option overrides whatever defaults may 
be set for your usual graphics output device and is useful when 
you are outputting to a variety of devices on a network or 
telecommunicating. 


/Global, Graphics, Options, Parallel 


Specifies the parallel port used to send data from your computer. 
Options are: 7 = LPT1:, 2= LPT2:, andj = LPT3:: 


/Global, Graphics, Options, Serial 


Com# Specifies the serial port used to send data 
from your computer. Options are: 7 = 
COM1:, 2 = COM2:, 3 = COM3:, and 4= 
COMA4:. 


Baud Specifies the data transmission rate. Rates are: 
1 = 110, 2= 150, 3 = 300, 4= 600, 5= 1200, 
6 = 2400, 7= 4800, 8 = 9600, and 9 = 19200. 


The remaining serial settings, like baud rate, must match the DIP 
switch settings on your output device. Check your printer or 
plotter manual for recommended settings. 


Parity Options are Odd, Even, None. 
Data-bits Options are 7or 6. 
Stop-bits Options are 7 or 2. 
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/Global, Graphics, Options, DOS 


Directs output as specified through DOS. Select DOS to use the 
DOS MODE= assignment or other output settings. 


/Global, Graphics, Options, Check 


Yes The initial default; directs the program to 
check the status of your printer or plotter 
when you send charts to it. SuperCalc warns 
you when the printer is not ready. 


No Sends charts for output without checking the 
ready status of your printer or plotter. 


/Global, Grapbics, Options, Zap 


Restores the defaults that were active when you last used 
/Global, Keep. 


/Global, Graphics, Options, Quit 


Returns to the /Global, Graphics menu. 


/Global,Spreadsheet 


Lets you select a spreadsheet printer, printer interface settings, 
extended ASCII or standard character tables, and — if you are 
using a supported laser printer or PostScript-compatible printer — 
lets you specify fonts for assignment to your spreadsheet cells. 
When you select /Global, Spreadsheet, these options display: Quit, 
Cartridges, Device, Fonts, Options, and Translation-tables. 


/Global,Spreadsheet,Quit 
Returns to READY mode. 
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/Global,Spreadsheet,Cartridges 


For Hewlett-Packard LaserJet users, lets you specify from one to 

three plug-in cartridges and/or from one to three Softfonts. When 

you select /Global, Spreadsheet, Cartridges, these options display: 

1, 2, 3, Softfonts, and Quit. — 


/Global, Spreadsheet, Cartridges, 1 - 3 


Selecting option 7, 2, or 3 displays a list of LaserJet cartridges for 
your selection. The number corresponds to the cartridge position 
in your printer. Select the cartridge that is located in that 
cartridge position. 


/Global, Spreadsheet, Cartridges, Softfonts 


Selecting Sofifonts displays these options: 7, 2, 3, and Quit. You 
can assign a Softfont to each number; select the font from the list 
that displays after you choose a number. Quit returns to the 
/Global, Spreadsheet prompt line. 


/Global,Spreadsheet,Device == 


Displays the Device Selection Menu, which is used to install your 
character printer. If you will be using a printer or plotter for 
graphics output, install that device using /Global, Graphics, Device. 


Character printer installation is a one-time program setup 
procedure. Repeat this procedure only if you change your 
character printer. To make your printer selection the program 
default for all work sessions, use /Global, Keep as described earlier 
in this section. 


If your printer is not listed, refer to the printer manual to see if your 
device emulates or is compatible with one of the devices listed. 


If you get extra spacing between lines, make sure that 

/Output,, Options, Paper, Line-feed is set to No and the automatic 

line feed DIP switch is turned Off. This is the default condition 7 
for most printers. SuperCalc sends a line feed to your printer 

when required. See Appendix G for recommended settings for 

most supported graphics printers and plotters. 
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/Global, Spreadsheet, Device, BE W-printers 


Displays a printer selection menu. To select your printer, use the 
Arrow keys to highlight its name or manufacturer and press 
Return. 


/Global, Spreadsheet, Device, Color-printers 


Displays a color printer selection menu. To select your printer, 
use the Arrow keys to highlight its name or manufacturer and 
press Return. 


/Global,Spreadsheet,Fonts 


If you have installed a supported laser printer or PostScript- 
compatible printer with /Global, Spreadsheet, Device, you can 
define up to eight type fonts for assignment to cells and ranges of 
your spreadsheet. Once you have defined them, you can assign 
the fonts with /Output, Attributes, Fonts. 


To define a font, select /Global, Spreadsheet, Fonts. These options 
display: Default, 1, 2, 3, 4, 5, 6, 7, and Quit. 


/Global, Spreadsheet, Fonts, Default 


Defines a default font for the entire spreadsheet. When you select 
Default, these options display: Face, Point-size, Bold, Italic, and 
Quit. Their settings determine all aspects of a font definition, as 
described below. Set each font element, then select Quit to 
return to the /Global prompt line. 


Face The font family or type style, for example, 
Courier, Helvetica, Times Roman, Zapf 
Dingbats. 

Point-size The size of the font in points, where each 


point is 1/72". The lower the number, the 
smaller the size. 


Bold Select Yes for heavy boldface type. Select No 
for medium type. 
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Italic Select Yes for slanted, italic type. Select No 
for vertical type. 


Select Bold, No and Italic,No for standard type 
like this. If the selected type face offers Bold 
Italic, you can select Bold, Yes and Italic, Yes 
to display it. 


Quit Returns to the Fonts prompt line. 


/Global, Spreadsheet, Fonts, 1 - 7 


Defines up to seven supplementary fonts for the entire 
spreadsheet. When you select one of these options, you can set 
Face, Point-size, Bold, and Italic, as described above under 
/Global, Spreadsheet, Fonts, Default. Select Quit to return to the 
Fonts prompt line. 


/Global, Spreadsheet, Fonts, Quit 


Returns to the /Global, Spreadsheet menu. 


/Global,Spreadsheet,Options 


Displays the Options Menu containing a list of output interface 
settings for communicating with printers, plotters, and modems. 
You can select from these options: Auto, Parallel, Serial, DOS, 
Check, Formfeed, Zap, and Quit. 


/Global, Spreadsheet, Options, Auto 


Selects device settings based on the manufacturer’s 
recommendations. This option overrides whatever defaults may 
be set for your usual character printer and is useful when you are 
outputting to a variety of devices on a network or 
telecommunicating. 


/Global, Spreadsheet, Options, Parallel 


Specifies the parallel port used to send data from your computer. 
Options are: J = LPT1:, 2= LPT2:, and 3 = LPTS:. 
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/Global, Spreadsheet, Options, Serial 


Com# Specifies the serial port used to send data 
from your computer. Options are: 1 = 
COM1:, 2= COM2:, 3 = COM3:, and 4= 
COMA:. 


Baud Specifies the data transmission rate. Rates are: 
1= 110, 2= 150, 3 = 300, 4= 600, 5= 1200, 
6 = 2400, 7= 4800, 8 = 9600, and 9 = 19200. 


The remaining serial settings, like baud rate, must match the DIP 
switch settings on your output device. Check your printer or 
plotter manual for recommended settings. 


Parity Options are Odd, Even, None. 
Data-bits Options are 7or &. 
Stop-bits Options are 7 or 2. 


/Global, Spreadsheet, Options, DOS 


Directs output as specified through DOS. Select DOS to use a 
DOS MODE= assignment or other output settings. 


/Global, Spreadsheet, Options, Check 


Yes The initial default; directs the program to 
check the status of your printer when you 
output to it. SuperCalc warns you when the 
printer is not ready. 


No Sends reports for output without checking the 
- ready status of your printer. 
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/Global, Spreadsheet, Options, Formfeed 
Indicates whether to use a formfeed character between pages in a 


multi-page document. 


Yes The initial default; inserts a formfeed character 
to move to a new page. 


No Uses printer linefeeds to move to the next 
page. 


/Global, Spreadsheet, Options, Zap 


Restores the defaults that were active when you last used 
/Global, Keep. 


/Global, Spreadsheet, Options, Quit 


Returns to the /Global, Spreadsheet prompt line. 


/Global,Spreadsheet,Translation-tables 


Specifies the character set to be used for report output. 


PC Extended The initial default; for printers capable of 

ASCII printing ASCII characters Decimal 32 through 
255. This allows you to print all of the ASCII 
extended character set, including accented 
characters and character graphics. 


96 Character The selection for printers capable of printing 
ASCII ASCII characters Decimal 32 through 127 only. 
/Global,Evaluation 


Sets the order in which SuperCalc evaluates and processes data. 
When you select /Global, Evaluation, these options display: Quit, 
Order, When, Iteration-control, Range. 


/Global,Evaluation, Quit 
Returns to READY mode. 
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/Global,Evaluation,Order 


Determines the order that SuperCalc recalculates your 
spreadsheet. All calculations begin with cell Al. The default 
order is Dependent. This setting is saved with your spreadsheet. 


/Global, Evaluation, Order, Dependent 


The initial default setting; defers the calculation of a forward 
reference until the cell calculation(s) that it depends on are 
complete. If SuperCalc finds a circular reference, a CIR message 
displays in the lower-right corner of your screen. The circular 
reference is calculated for the number of iterations specified, or 
until the reference is resolved. 


/Global, Evaluation, Order, Row 


Calculates each cell across a row from left to right before moving 
down to the next row. If SuperCalc encounters a forward or 
circular reference, it automatically recalculates according to the 
current iteration setting. 


/Global, Evaluation, Order, Column 


Calculates cells down a column from top to bottom before 
moving right to the next column. If SuperCalc encounters a 
forward or circular reference, it automatically recalculates 
according to the current iteration setting. 


/Global,Evaluation, When 


Determines when recalculations take place. The 
/Global, Evaluation, When setting is saved with your spreadsheet. 


/Global, Evaluation, When,Manual 


Withholds recalculation until you press the F9 key. 
Manual can help save time when you are making many data 
entries into a large spreadsheet; as you don’t need to wait for 


recalculation after each entry. On the other hand, Auto 
recalculation always keeps your spreadsheet updated. 
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/Global, Evaluation, When, Auto 


The default; recalculates the entire spreadsheet each time new 
data is entered or after the spreadsheet is modified. 


/Global,Evaluation,Iteration-control 


Lets you build models containing circular or simultaneous 
formulas and goal-seeking models. Spreadsheets with circular or 
forward references may require multiple calculations to achieve 
the desired or correct results. Jteration-control recalculates the 
spreadsheet until all circular references within a user-defined 
convergence range are resolved. You can specify the maximum 
number of iterations or let SuperCalc continue until the circular 
references are resolved to a specified degree of precision — the 
resolution Delta. Note, however, that some models will not 
converge; in fact, they diverge. 


When designing a model using iteration: 


m A forward reference consists of a cell containing a formula 
that references another cell with a higher cell address. For 
example: Cell Al contains BK1*DW2000, where BK1 and 
DW2000 are higher addresses. 


m A circular reference consists of a closed loop of cell 
references. That is, the last cell in a forward reference chain 
contains a reference to the first cell of the chain. This 
sometimes represents a series of simultaneous equations. The 
simplest case is a cell that references itself. For example: 

Cell Al contains A1+A2. 


m The cell delta is the amount that a circular cell changes during 
a single iteration. Because a circular cell's value depends 


upon values of other cells in the loop, the cell delta may not 
remain constant for subsequent iterations. 


—— 
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Cell Delta 


SuperCalc uses the cell delta internally; you 
cannot access it. Cell delta is defined here only 
to help explain the iteration procedure. 


A converging cell is a circular cell whose cell delta becomes 
smaller with each iteration. Such a cell will eventually be 
resolved. 


A diverging cell is a circular cell whose cell delta becomes 
larger or remains unchanged with each iteration. Such a cell 
will never be resolved; the spreadsheet will calculate until the 
size of the number exceeds the program limit. To stop 
calculating, press any key with /Global, Optimum, Present, 
Interruptible set to Yes, or press CtrHBreak. 


Delta (resolution delta) is a numeric value that determines the 
precision of convergence. You can use the default .01 
(penny) or specify any other value. The (resolution) Delta is 
different from the cell delta. With each iteration SuperCalc 
compares every circular cell delta with Delta. When a circular 
cell's cell delta is less than Delta, SuperCalc considers that cell 
resolved. 


The convergence range is a user-defined range that SuperCalc 
uses to test for convergence. When all circular cells within 
the convergence range have been resolved, iteration stops. 


- Circular cells outside the convergence range are 
calculated with each iteration but are not included in the 
convergence test. Initially, the convergence range is the 
entire spreadsheet. 


- If the convergence range contains a divergent cell, 
iteration will continue indefinitely. To interrupt iteration, 
press any key with /Global, Optimum, Present, 
Interruptible set to Yes, or press CtrHBreak. 
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For example, suppose cell Al contains A1+1. This is 
a divergent cell and the spreadsheet will iterate 
indefinitely. You must define a convergence range 
that excludes cell A1. 


Another way to redefine the convergence range is to use 
a conditional statement for Delta that changes Delta to a 
very large number. 


For example, assign cell AA1 as the Delta cell with 
/Global, Iteration-control, Solve, Delta, AA 1. 


Then place a formula similar to this in AA1: 
IFATER=20,9e62,.001) 


This causes Delta = .001 for the first 20 iterations and 

Delta = 9 x 10162 to be used for iteration 21. Since 

it is highly unlikely that even a diverging cell delta 

will be larger than 9 x 10162, iteration will stop with 

the 21st recalculation (provided that the spreadsheet 

was not resolved earlier). == 


Notice that this technique may be the only way to 
control a divergent cell since the convergence range 
must be one contiguous block, which may contain a 
divergent cell. 


For more information and an example, see Goal- 
Seeking Model Sample, later in this chapter. 


When you select /teration-control, SuperCalc displays these 
options: Solve, Fixed. 
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/Global, Evaluation, Iteration-control, Solve 


The initial default setting; lets iteration continue until all circular 
cells within the convergence range are resolved. You can select 
from these options: 


Quit Returns to /Global, Evaluation menu. 
Delta Specifies convergence resolution. 
a — — Sets Delta to .01, the program 
default. 
a Cell — Specifies a cell reference. 


SuperCalc uses the absolute value of 
this cell for Delta. 


Range Specifies the convergence range. Initially the 
convergence range is the entire spreadsheet. 
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Goal-Seeking Model Sample 


The following financial model uses Iteration-control, Solve to 
estimate sales required to yield a desired net income: 


LOE | 
54, 888 Goal Seeking Example: 
32,488 Compute Sales to Yield Desired Net Incone, 
Where Income is Arbitrary Function of Sales, 


r.a Profit 21,684 


Desired Net 
en & Admin 8,1898 

ixed Cost 1,988 
Tot Expenses 9,184 


12,548 
2,588 


10,808 


Form=108088 
9 Memory: 65 Last Col/Row: E28 


READY Fi:Help F3:Names Ctrl-Backspace:Undo Ctrl-Break'Cancel CIR 


Ea 


The model defines Costs as a percentage of Sales; Gr. Profit as 
Sales minus Costs; Gen and Admin as a percentage of Sales, 
Net Bef. Tax as Gr. Profit minus Tot Expenses; Income Tax as 
a percentage of Net Bef. Tax; and Net Income as Net Bef. Tax 
minus Income Tax. Thus, all calculations are based directly or 
indirectly on Sales where Sales is defined as Sales (cell B1) plus 
DELTA (cell B2). 


This model is circular because it iteratively varies Sales by a delta 
(Sales = Sales + DELTA) while examining the effect on the 
bottom line. That effect is used to compute a new Sales delta for 
the next iteration. 
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The goal-seeking portion of the model includes the formula in 
cell B1 plus those in cells B16 through B20, shown below in 
Formula mode: 


ae 
B1+DELTA Goal Seeking Example: 
64~B1 Compute Sales to Yield Desired Net Incone, 
IAS Where Income is Arbitrary Function of Sales. 
B1-B2 


Desired Net 
154B1 
1988 


SUM(B6 -B7) 


B4-B39 
28:B11 


B11-B12 
E5-B14 
IF (MODCITER,23=1,UARI ODD) 
IF (MODCITER,2)=8,UARI, EVEN) 
TF CEUEN=0DD, , 1 ¿UAR I4CEUEN-0DD 1) 
IFCITER=1,) 82) CIFLUARI>8 /MULT+DELTA , -MULT*DELTA) 1) 
! Form= 1480098 
Width: 9 Memory: 65 Last Col/“Row: E28 
1> 
READY F1:Help F3:Names Ctrl-Backspace:Undo Ctrl-Break:Cancel CIR 


When you enter Desired Net into cell E5, the goal-seeking 
formulas control iteration by ensuring that the calculated Net 
Income in cell B14 is converging toward the Desired Net 
amount: 


W VARI determines whether the variance between calculated 
Net Income and Desired Net is positive. 


E ODD and EVEN keep a record of the last two VARI 
calculations. 


NW MULT prevents division by 0 and controls the amount of 
DELTA. 


W DELTA controls the direction (upwards or downward) and 
degree of change in cell B1 and, indirectly, calculated Net 
Income (cell B14). As Desired Net income values converge, 
DELTA becomes smaller but continues to become positive or 
negative as needed to bring about convergence. 
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The minimum number of iterations is automatically performed, 
and calculation halts when the goal has been met. 


This model is included in the SuperCalc package as GOAL.cal. 
You can load it with /Load, Replace and experiment by entering 
different values into cell E5. 


/Global, Evaluation, Iteration-control, Fixed 


Lets you enter the maximum number of iterations from 1 to 99. 


Iteration Notes 


1. Pressing any key cancels iteration unless 
/Global, Optimum, Present, Interruptible is off, then use Ctrl- 
Break. Effects of the calculation to that point are reflected in 
the results. 


2. When using the Solve option, a nonconvergent circular 
reference within the convergence range causes iteration to 
continue indefinitely. Redefine the convergence range to 
exclude the divergent cell. 


3. SuperCalc updates the values on the screen with every 
iteration so that you can monitor the progress of a lengthy 
series of iterations. This has some impact on recalculation 
speed, so paging to a part of the spreadsheet not affected by 
iterations improves speed. 


/Global,Evaluation,Range 


Specifies the range to be recalculated; only this range will be 
recalculated to save time. Enter a hyphen (-) to clear the current 
range entry and extend the recalculation range to the entire 
spreadsheet. 
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/Global,Values 


Displays status screens of global settings for the current 
spreadsheet. Pressing any key other than Esc displays the next 
screen. The screens consist of information about: 


1. Filenames, datapaths, /Global toggle settings, evaluation 
order, format settings at a particular level, and memory status. 


2. Settings for each windows created with /Window. 


3. Defined ranges for data management and analysis options. 


4. All remembered ranges except those set with /Output. 


On/Off Toggles 


The remaining options are toggles, that is they can be turned on 
or off. The toggle options are: Formula, ", Labels, Protection, 
Border, Next, Tab, Unprotected, Zoom. 


When you select the option, it changes to the opposite state — if 
on it is turned off and vice versa. The assertion toggles + and — 
let you designate the state for toggle options. 


If the current toggle setting is on, the option is highlighted (white 
on a color monitor) on the prompt line. 


+ Turns the specified toggle on. The previous state of the toggle 
does not matter. 


— Turns the specified toggle off. The previous state of the toggle 
does not matter. 


/Global,Formula 


Alternates the spreadsheet between displaying the cell contents 
and the cell values. Cell content is the literal data entered into the 
cell, such as a formula or a number. The cell value is the result of 
evaluating the cell content, such as the number produced by 
evaluating a formula. The default is off. 
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When Formula is on, cells containing formulas display the 
cell contents. 


When Formula is off, formula cells display the cell values. 


/Global," 


Toggles Text and Formula Entry modes. The default is off for 
Text Entry mode. 


When /Global, "is on, you are operating in Formula Entry mode 
and the leading " is required for text entries. SuperCalc evaluates 
each entry not preceded by ", and checks for proper formula 
format. If the entry is not a formula, the message Formula Error 
appears in the lower-right corner of your screen and you can 
correct the entry. 


When /Global, "is off, SuperCalc is in Text Entry mode; the 
leading " is optional. SuperCalc evaluates your entry and, if it is 
not a formula or a command, supplies the leading " in the cell 
contents and displays the message TEXT in the lower right corner 
of your screen. 


To enter a number, formula, or cell address as text, precede the 
entry with ". The leading " is also required if the text begins with 
?=!?; " &Or/ 


/Global,Labels 


Toggles the display of range names and range cell references in 
spreadsheet formulas. The initial default setting is on. 


When /Global, Labels is on, if the name does not contain mixed 
mode references, the names of ranges are displayed in the 
formulas. 


When /Global, Labels is off, the range displays in formulas as a 
pair of cell references (such as D6:K125), even if it has been 


named. 


Labels mode can be temporarily switched on with the F7 key 
during formula entry. 
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/Global,Protection 


Temporarily toggles the shield of protection that has been placed 
on cells using /Protect. The default for SuperCalc is on. 


When /Global, Protection is on, data cannot be entered or edited 
within cells that have been protected with /Protect. Protected 
cells are displayed in color or half-intensity. 


When /Global, Protection is off, cell protection is temporarily 
turned off. Any cell can be overwritten or edited. This is the 
default state for Lotus 1-2-3. To emulate Lotus 1-2-3 protection, 
turn /Global, Protection and /Global, Unprotected off. You may 
keep these changes as future defaults. 


If you turn protection off, repeat /Global, Protection when you are 
through editing, deleting, and so on. The word Protection is 
again highlighted (white on a color monitor) on the prompt line, 
and the /Protect shield of protection is again honored. 


When the Tab, Protection, and Next toggle options are on, the 
cursor moves automatically to the next unprotected, non-blank 
cell after data entry. 


/Global,Border 


Turns the screen display of the column/row borders on and off. 
The border display is row numbers along the left side and column 
letters along the top of the spreadsheet. The default is on. 


See /Output, Options for information about turning the border on 
and off for printing. 


/Global,Next 


Toggles the spreadsheet cursor auto-advance feature. The default 
is on. 


When /Global, Next is on, the spreadsheet cursor advances in the 
current direction after an entry of data with a Return. The 
current direction is shown by the cursor direction indicator arrow 
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in the first column of the status line. It is determined by the 
direction of the prior cursor move. 


When /Global, Next is off, the spreadsheet cursor does not 
advance automatically. The cursor direction indicator is absent 
from the status line. 


/Global,Tab 


Turns the cursor lockout option on and off. With Tab mode on, 
the cursor automatically jumps to only non-blank, non-protected 
cells. The Tab option is useful to speed data entry by skipping 
designated cells. The default is off. 


When Tab is on, the spreadsheet cursor keys can position the 
cursor in non-blank, non-protected cells only. 


When Tab is off, the spreadsheet cursor may be positioned in any 
cell. 


Goto (F5) can position the cursor at any cell, even when 
/Global, Tab is on. 


Tab is particularly useful with the Restrict command — 
especially when using //Restrict in a macro template. 


/Global,Unprotected 


Specifies whether cells are normally protected or unprotected. 
Protected cells cannot be overwritten or edited. 


When Unprotected is on, cells in the spreadsheet are normally 
available for data entry and editing. In order for cells to be 
shielded from change they must be explicitly protected with 
/Protect. Data is not protected when entered, and blank cells are 
treated as not protected. 


When Unprotected is off, cells in the spreadsheet are normally 
shielded from change. In order for cells to be available for data 
entry and editing they must be explicitly unprotected with 
/Unprotect. Everything you enter is protected and blank cells are 
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treated as protected. You can only enter and edit data if 
/Global,Protection is also off. 


Unprotected on is the SuperCalc default. Unprotected off emulates 
Lotus 1-2-3 cell protection. 


/Global,Zoom 


Moves between standard and expanded screen displays when 
EGA or VGA boards are present. When /Global, Zoom is on, 
systems with EGA boards display 43 lines while systems with VGA 
boards display 50 lines. 


/Global, 1-2-3 


Puts SuperCalc into “Lotus Compatibility mode.” All subsequent 
commands are interpreted according to Lotus 1-2-3 menus until 
you return to SuperCalc menus with /Worksheet, Global, sc 5. 


When working in Lotus Compatibility mode, you can use single 
SuperCalc command sequences by preceding the command with 
/sc5. For example, /sc5, Global, Values (/5GV) displays the first 
SuperCalc Global Values screen. As soon as the command 
executes, SuperCalc returns to Lotus Compatibility mode. 


Before entering Lotus Compatibility mode, you may wish to 
change default cell protection to emulate Lotus 1-2-3 default 
behavior. Use /Global, Protection and /Global,—Unprotected. 


To give single Lotus 1-2-3 commands from within SuperCalc, 
precede the Lotus command sequence with /1 (for /1-2-3). After 
issuing the command, SuperCalc menus are restored. For details, 
see /1-2-3 later in this chapter. 
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/Insert 


/Insert adds a row range, column range, or block of empty cells 
and adjusts the formulas for the remainder of the spreadsheet. 
Chapter 4 of the User's Guide tells more about using this 
command. 


/Insert, — Row,row range 
Column,column range 
Block,range, a Down (move old range data down) 
Right (move old range data right) 
Page, page range 


/Insert,Row 


Adds blank rows within a specified row range; pushes down the 
specified row(s) and all rows beneath them. 


/Insert,Column 


Adds blank columns within a specified column range; pushes 
specified columns to the right along with all columns to the right 
of them. 


/Insert,Block 


Pushes existing data down or to the right, to accommodate the 
specified block range. 


/Insert,Page 


Inserts a new page (or pages) where you specify. The remaining 
pages are renumbered accordingly. 


Examples 
Insert a row between rows 4 and 5: 


/Insert,Row,5 Return 


Insert 3 columns between columns D and E: 


/Insert,Column,E:G Return 
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Insert a block, adjusting data down: 


/Insert,Block,C7:E19 Down 


Insert a page between pages 3 and 4: 


/Insert,Page,4 Return 


Special Considerations 


_ 1. Ansert adjusts absolute cells references (such as $A$1). 


2. If /Insert would push any cells past the last row or column of 
the spreadsheet, SuperCalc will not allow the insert. You 
must first delete an appropriate number of rows or columns. 
If you prefer to increase the size of your spreadsheet, use 
/Global, Optimum, Next, Boundary and /Global,Keep. Then, 
save your spreadsheet, quit, and start a new SuperCalc 
session before inserting. 


3. Inserted rows or columns take on the Global or General 
display formats. 
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/Justify 


/Justify lets you justify text over a desired width, which you 
specify by selecting a range of columns. The Word-wrap option 
acts as a word processor for continuous text entry. 


Multiple, block range,(Left/Center/Right) 
Word-wrap, m Go 

- Range,input range 
Width,column width 


Justify, ! Single, block range, (Left/Center/Right) 


/Justify differs from /Format, TextLeft, TextRight, and TextCenter 
because it operates on a block of text independent of column 
widths, while the /Format options operate within single columns. 
The /Justify options override justifications set through /Formal. 


/Justify,Single and Multiple are applied after text has been entered. 
To wrap text as it's entered, use /Justify, Word-wrap first. 


/Justify,Single 


Lets you justify text over a width, specified as a range of columns. 
The text must begin in the first column of the specified range; 
only the text in the first column will wrap. Justification will stop 
at the first non-text cell encountered. 


After selecting /Justify,Single, specify (or point to) the range of 
columns within which to wrap the text. You need only specify 
the first row; text will wrap until a non-text cell in the first column 
is reached. Then, specify Left, Center, or Right for alignment of 
text within each row. 


/Justify,Multiple 


Lets you wrap rows of text which may be interrupted by a non- 
text cell. The text must begin in the first column of the specified 
range, and justification will stop when two consecutive non-text 
cells are encountered. Only text in the first column will wrap. 
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As with /Justify, Single, specify the range of columns within which 
to wrap the text, then specify Left, Center, or Right alignment. 


/Justify Options 


The following options are offered for both /Justify, Single and 
/Justify, Multiple: 


/Justify, Left 


Justifies text flush left, word-wrapping to conform to the range 
specified. SuperCalc includes as much text as possible on each 
line when justifying Left. A single blank space is retained 
between words. 


/Justify,Center 


Centers each text string, line by line. 


/Justify,Right 


Moves each text string flush right, line by line. 


If a text string is too long to Center or Right justify within the 
range, the string is not moved. 
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Range Guidelines 


When prompted for a range, observe these guidelines: 


1. The text must start in the first column of the specified range. 
Only text in this column will wrap. 


2. A text string can be wider than the width of the first column; 
it can “spill-over” into adjoining columns. 


3. Rows of text must be consecutive when you select Justify, 
Single. Rows of text can include a blank or non-text row 
with /Justify,Multiple, paragraphs end at the first two 
consecutive non-text cells in the first column of the specified 
range. 


4. The number of rows the text wraps across depends on the 
lengths of the text entries and the width of the specified 
column range. 


5. Qualified text will wrap within the specified range only. 
Other occupied cells within the range will be shifted away 
from the wrapped text, if possible. If the text will not fit in 
the range specified, or if occupied cells outside the block are 
affected, a message indicates there is not enough room for 
the justify. 


Examples 


The examples in this section all refer to this spreadsheet: 


This is spill-over text entered into cell AZ. 
This spill-over text was entered into cell AJ, Text in cell G3 


Spi l-over text entered into cell AS. 
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Example 1 
/Justify Single,A2:C2,Left 


ntered into cell A2, This Text in cell G3 
pill-over text was entered 


pill-over text entered into cell AS, 


The qualified text strings are left-justified, down to the first blank 
(non-text) cell in column A. The text in row 5 is shifted down to 
row 7. This maintains the same distance between the justified 
text and other occupied cells in the specified range. 


Note that the text in cell G3 was not affected. 


Example 2 
/Justify,Multiple,A2:C2,Left 


ntered into cell A2. This Text in cell G3 
pill-over text vas entered 


All text strings are left-justified. The text in cell A5 was justified 
because it was separated from the text in cell A5 by only one 
non-text cell. 
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Example 3 
/Justify,Single,A2:F2,Right 


This is spill-over text entered into cell AZ, 
This spill-over text vas entered into cell A3.Text in cell G3 


Spill-over text entered into cell Ab, 


The right-justified text ends at the first blank (non-text) cell, A4, 
encountered in column A. 


Example 4 
/Justify Multiple, A2:F2,Center 


This is spill-over text entered into cell AZ, 
This spill-over text was entered into cell Al, Text in cell G3 


Spill-over text entered into cell A5. 


All text strings are centered. 
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/Justify, Word-wrap 


/Justify, Word-wrap lets you type continuously without pressing 
Return. 


Lets you type text to fit a specified width. When the text exceeds 
the width, the portion that fits is entered into the current cell. 
Then, the cursor moves down one line and the remaining portion 
of the entry moves to the beginning of the entry line. All text is 
left-justified. To right- or center-justify text, use /Justify, Single or 
Multiple when text entry is complete. 


/Justify, Word-wrap,Go 


Switches to WRAP mode and begins entering your text into the 
specified range at the specified width. You must select Range 
before Go. 


/Justify, Word-wrap,Range 


Lets you specify the range for text entry. The range can be a 
single cell, part of a column, or an entire column. See Word-wrap 
Considerations, below. 


/Justify, Word-wrap, Width 


Lets you specify the width, in characters, of the text you are 
entering. Text up to 240 characters wide is entered into a single 
column regardless of that column’s width. The default width is 


65. 


Word-wrap Considerations 


WRAP mode terminates when you: 
NW Press Return with no text on the entry line. 
NW Cursor outside the column range. 


m Try to write over a protected cell. 
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m Fill up the computer’s memory. 

m Press Esc. 

If the specified range is a single cell, the above termination rules 
apply with this difference: WRAP mode terminates when trying to 
write over any nonblank cell, whether protected or not. 

Left and Right Arrow provide immediate exit from WRAP mode. 
Down Arrow after Return will produce a blank line without 
terminating WRAP mode. 


No commands can be executed while in WRAP mode. 


The Undo command, Ctri-Backspace, restores the spreadsheet to 
the state it was in prior to text entry. 
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/Load 


/Load reads spreadsheet cell contents, cell values, and format 
settings from a disk file into the current spreadsheet. You may 
load all or part of the spreadsheet, into the location you specify. 
Options include formula adjustment, values only, and 
consolidation arithmetic. You can also load chart descriptors 
(formats, headings, chart types, and so on) or named ranges from 
another SuperCalc spreadsheet into the current spreadsheet. 


/Load, filename, - Replace [Modification? No/Yes} 

All 

Values 

Consolidate 

Part, from range,to range i 

, m No-adjust 

Ask 
Values 
+ 


/ 
Names 
Graphs, from chart,to chart 
Single, page, > Replace [Modification? No/Yes} 
All 
Values 
Consolidate 
Part, from range,to range C 
, m No-adjust 
Ask 
Values 
n 
* 
/ 
Names 
Graphs, from chart,to chart 
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After selecting /Load, enter the name of the file you wish to load, 

preceded by the disk drive and/or directory, if necessary. 

Otherwise, SuperCalc looks in the current data drive-directory or 

searches the current data path (see //File,Path). It first looks for a 

file with the -cal extension unless you specify otherwise, then 

Wk1 and .wks extensions. g 


When you select /Load, the default filename appears on the entry 
line (whichever file you last loaded with /Load,All or Replace, 
saved with /Save,All, or renamed with //Spreadsheets, Rename). 
You can accept this filename, or: 


m Begin typing a new filename. 
MH Press F2 Or Backspace to edit the filename. 


NW Press F3 to reach the File List. 


/Load Options 


After specifying the filename, you have the following options: 
Replace, All, Values, Consolidate, Part, Names, Graphs, and Single: 


/Load,Replace 


Clears the current spreadsheet and loads all pages of the specified 
file. This is the equivalent of /Zap, Yes followed by /Load, All. If 
the current spreadsheet has been edited but not saved, a message 
reminds you to save your changes. If you need to save the 
current spreadsheet, select No to cancel /Load, Replace. Select Yes 
to proceed with the /Load command. 


/Load,All 


Loads all pages of the entire spreadsheet exactly as it was saved. 
If you don’t /Zap the current spreadsheet first, /Load, All will load 
on top of the current spreadsheet. See the section File 
Combination without Operators for details. 
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/Load,Values 


Loads only the calculated values of formulas and display formats 
at the Entry level. Formulas are not loaded. Dates load as DVAL 
functions, and times load as TVAL functions. 


/Load,Consolidate 


Combines corresponding cells of the disk file and the current 
spreadsheet and places the result into the spreadsheet. The 
following types of cells are not affected: text cells, control text 
cells, protected formula cells, date and time cells, N/A cells, 
ERROR cells, and cells resulting in string values. Cells are 
combined using the addition operation of consolidation 
arithmetic. See Consolidation Arithmetic later in the /Load 
section. 


/Load,Part 


Loads a portion of the spreadsheet, with additional options. You 
are prompted to enter the range you want to load, and where in 
the current spreadsheet to place it. 


m Use the Part option if your file is larger than the current 
Spreadsheet Boundary setting. Note that you can design an 
\ AUTOEXEC macro to automate this process. 


m Use /Load,Part and specify the from range as ALL to use 
options such as No-adjust, Ask, Values, +, —, *, or / 


To load a partial spreadsheet, select /Load, specify the file, and 
select Part. Then, specify the source range (the from range) and 
the destination cell (to range). The destination cell becomes the 
upper-left corner of the region holding the loaded data. 
SuperCalc assumes that the to range will become the same size as 
the from range when filled. 


With a partial load, SuperCalc loads only the cell contents and 


Entry level formats. It ignores all other formats and default values 
on file for the source spreadsheet. 


SuperCalc Commands 2-115 


/Load 


/Load,Part Options 


Type a comma after typing the from cell to display a list of 
/Load, Part options: No-adjust, Ask, Values, +, —, * and / The last 
four options operate under SuperCalc's rules for consolidation 
arithmetic, discussed later in this chapter. 


/Load,Part,No-Adjust 


Loads cell contents literally with no formula adjustment. 


/Load,Part,Ask 


Prompts for formula adjustment for each cell loaded. The entry 
line displays the formula and the prompt line displays the source 
cells. Respond Yes or No as required. 


/Load,Part,Values 


Loads cell values only as numeric constants. Formulas do not 
load. Dates change to their DVAL function value. Times change 
to their TVAL function values. 


e 


/Load,Part,+ 


Adds each disk file cell value to the corresponding spreadsheet 
cell value and enters the sum into the destination cell as a 
numeric constant. 


/Load,Part,— 


Subtracts each disk file cell value from the corresponding 
spreadsheet cell value and enters the difference into the 
destination cell as a numeric constant. 


/Load,Part,* 


Multiplies each disk file cell value by the corresponding 
spreadsheet cell value and enters the product into the destination had 
cell as a numeric constant. 
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/Load,Part,/ 


Divides each spreadsheet cell value by the corresponding disk file 
cell value and enters the quotient into the destination cell as a 
numeric constant. 


Consolidation Arithmetic 


When cells in two spreadsheets or cell ranges are combined 
arithmetically using the +, —, *, or / options, we call that 
procedure consolidation arithmetic. Consolidation arithmetic 
occurs with /Copy, (options), /Load, Consolidate, 

/Load, Part, (options), and //Import, Consolidate. 


The effect of each consolidation arithmetic operation depends 
upon the contents of the corresponding spreadsheet and disk file 
cells. There are four cases to consider: 


m A blank spreadsheet cell and a blank disk file cell result in a 
consolidated blank cell. 


m For Consolidate and +: A blank spreadsheet cell is treated as 
0 (zero), resulting in a consolidated disk file cell. For 
Consolidate and —, a blank spreadsheet cell is treated as 0, 
resulting in the negative of the disk file cell. 


For * and /: A blank spreadsheet cell and a nonblank disk 
file cell result in a consolidated blank cell. 


m A nonblank spreadsheet cell and a blank disk file cell result 
in a consolidated cell that is unchanged from the spreadsheet 
cell. 


m A numeric spreadsheet cell and a numeric disk file cell result 
in a consolidated cell that is the result of the selected 
operation. 


The following types of cells are not affected: text cells, control 


text cells, protected formula cells, date and time cells, N/A cells, 
ERROR cells and cells resulting in string values. 
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/Load, Consolidate only performs addition; this command 
sequence is the same as /Load,, Part, ALL,A1, +. 


File Combination without Operators 


You can load a disk file on top of a spreadsheet file without using 
an arithmetic operator. This occurs with /Load, Part, 

/Load, Part, Options (except +, —, *,/) and /Load, All. Corresponding 
cells of the disk file replace those of the current spreadsheet file. 
There are four cases to consider. 


m A blank spreadsheet cell and a blank disk file cell result in a 
blank cell. 


m A blank spreadsheet cell and a nonblank disk file cell result 
in the contents of the disk file cell. 


m A nonblank spreadsheet cell and a blank disk file cell result 
in the contents of the nonblank spreadsheet cell. 


m A nonblank spreadsheet cell and a nonblank disk file cell 
result in the contents of the nonblank disk file cell. w 


Consolidation Hints 


If you are somewhat unsure of the effects of consolidation, you 
may want to save the current spreadsheet first as insurance. 
Alternately, you may want to protect certain areas of the current 
spreadsheet prior to consolidation. 


/Load,Names 


Loads the named ranges from the disk file into the current 
spreadsheet. Named ranges are part of the spreadsheet. They are 
saved with /Save,All and loaded with /Load,All and Replace. 
Loaded names are added to the current name list Gif any) and thus 
duplicate names may redefine existing names. 
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/Load,Graphs 


Loads chart descriptors from the disk file into the current 
spreadsheet. You have the options All or Single. Single prompts 
for the-chart name. 


/Load,Single 


Loads a page from another spreadsheet into the current 
spreadsheet. You are prompted to specify the page number in 
the source file that you want to load. 


Examples 


To load chart descriptor Bar from a file QUARTER.cal as chart 
Barl: 


/Load,QUARTER,Graphs,Bar, 

Barl Return 
To load the entire file QUARTER.cal from the current data drive- 
directory: 

/Load, QUARTER, Replace 
To load the entire file QUARTER.cal without formula adjustment 


from directory CALC located one level below the current data 
directory: 


/Load, CALC1QUARTER)Part,ALL,A1,No-adjust 
To load values from range F4:F25 of INCOME.cal on drive B and 
place them in the current spreadsheet starting at cell A4: 
/Load,B:INCOME Part,F4:F25,A4,Values 
To sum the values of the current spreadsheet with those of a disk 
file, SALES.cal: 
/Load, SALES Consolidate 
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To sum the values of a section of the current spreadsheet with 
those of a disk file, NEW.cal: 


/Load,NEW,Part,C3:F20,C3,+ 


Special Considerations 


1. Protected cells in the destination area will remain unaffected 
by a /Load command in all cases except one: /Load, Replace 
will zap protected cells. 


2. If you try to load a large spreadsheet created with a prior 
version of SuperCalc, the program might issue a “Memory 
full” message (this version occupies more memory than prior 
versions). 


3. When you use named ranges with /Load, Part, you must first 
define the names in their respective spreadsheets. 


For example, /Load, SAMPLE, Part, SALES, MYSALES requires 
that the disk file SAMPLE.cal contain a named range SALES 
and the current spreadsheet contain the named range 
MYSALES. 


4. Loading a chart descriptor will overwrite, without notification, 
a descriptor with the same name in the current spreadsheet. 


5. To load files created by Lotus 1-2-3, specify the appropriate 
extension (.wks or .Wk1). If you enter the filename without 
an extension, SuperCalc will look for .cal files first, then .wk1 
and .wks. You can change the default file extension with 
/Global, Optimum, Present, Extension. 


For additional file formats other than Lotus 1-2-3, use 
//Import. See the //Import command discussion in this 
chapter for more information. 


6. The last occupied row and column of the file to be loaded 


cannot be greater than the current Spreadsheet Boundary set 
with /Global, Optimum, Next, Boundary. 
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/Move 


Moves a row range, column range, or block to a new location and 
adjusts the formulas. 


/Move, r Block, from range,to range i 
: Normal 

, E Transpose 

Row, from row range,to row number 

Column, from column range,to column letter 

Page, from page range, to page range 


/Move transfers a block, column range, or row range to a new 
location. SuperCalc adjusts the formulas without destroying any 
data or formatting. You can transpose rows/columns of a block. 


/Move,Block 


/Move, Block moves a block to a new location. A block move 
overwrites the cells in the new location. Data previously located 
there is lost. 


/Move Options 


Typing a comma (,) after the to range displays the options Normal 
and Transpose: 


/Move,Block,Normal 


Moves the block without transposing the rows and columns. 


/Move,Block,Transpose 


Moves the block and transposes the rows and columns of the 
moved block (the rows become columns and the columns 
become rows). All references to transposed cells are adjusted to 
refer to the new location. You can only transpose a block. You 
cannot transpose a full column into a row since a full column is 
larger than a full row. The message Copy won't fit will display. 
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/Move,Row 


Moves an entire row range up or down. The rows between the 
new and the old location (including the target row) move in the 
opposite direction to fill in the space. 


/Move,Column 


Moves an entire column range left or right. The columns between 
the old and new locations (including the target column) move in 
the opposite direction to fill in the space. 


Column and Row Adjustment 


Where the data is placed depends upon the direction of the 
move: 


m Moving down puts the moved rows below the target row. 
æ Moving up puts the moved rows above the target row. 


NW Moving right puts the moved columns to the right of the 
target column. 


m Moving left puts the moved columns to the left of the target 
column. 


/Move,Page 


In multipage spreadsheets, moves a page or page range within 
one spreadsheet. Moving to a higher page number puts the 
moved pages behind the target page. Moving to a lower page 
number puts the moved pages before the target page. 


2-122 SuperCalc Reference Manual 


/Move 


Examples 

Move row 5 between rows /Move,Row,5,11 Return 

11 and 12: 

Move columns C through E /Move,Column,C:E,I Return 


between columns I and J: 


Move a block: /Move,Block,C10:F20,AZ100 
Return 


Move a block and transpose /Move,Block,A1:C6,E1, 
it: Transpose 


Becomes: 


Special Considerations 


1. If you move the contents of the first or last address of any 
remembered cell range, or the range used in a formula or 
named range, the range is re-defined accordingly. 


For example, take the range C1:F10. If you move the 
contents of F10 to K25, the range is re-defined as C1:K25. To 
move the contents of such a cell without re-defining the 
range, use /Copy, then /Blank if you want to erase the 
contents of the source cell. 
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2. If you want to move the contents of a row or column, you 
can avoid dislocating the contents of other rows or columns 
(no fill in) by using the /Copy and /Blank commands instead 
of /Move. 


3. With /Move, all references to moved cells, including absolute 
cell references such as $A$1, are adjusted to refer to the new 
locations. 


4. You can either type or point to the range of rows or columns 
to move for /Move, Row and /Move, Column. 
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/Name 


/Name lets you assign a name to a cell range. You can 
subsequently use that name for the range in formulas and 
commands. 


/Name, -- Create,range name ,range 
Delete,range name 


Labels, i Right,range 


Down,range 


Left, range 
Up,range 
Table, range 
Zap, No 
Yes 


Once you have assigned a name to a cell range (named a range), 
you can substitute that name in any command or formula where a 
cell range is valid. You need not remember the boundaries of a 
group of cells that are logically related. You can enter the name 
directly or press F3 to select the name from the Named Range 
Directory. 


When you define a named range, the name replaces all of the 
corresponding cell ranges in the spreadsheet. For example, if you 
define JANUARY to be the range B1:B12, the formula 
SUM(ANUARY) replaces SUM(B1:B12) if /Global, Labels is turned 
on. Use /Global, Labels to toggle between range name and cell 
reference display in formulas. 


/Name,Create 


Assignes a name to a range. You must create a named range 
before you can reference it in a formula or command. To create a 
named range, you specify the name and its corresponding range. 


m A name can be up to 32 characters long. 


m Valid characters in a range name: 
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Leading backslash (\) — optional as the first 
character only. 


Letters (A-Z or a-z) — the program converts lower- 
case entries to upper-case. 


Numerals (0...) — the name must include at least 
one letter; “80 avg” is valid; “80” alone is not valid. 


Underscore ( _ ) — valid only if used with at least 
one letter. 


Space ( ) — the program compresses multiple 
spaces to a single space, and discards leading and 
trailing spaces. 


A name containing spaces is considered identical to 
the same name with more or fewer spaces, or no 
spaces at all. These three names are equivalent: 


NEWYORK NEW YORK NEW YORK 


m Upper-case ASCII extended characters are accepted as 
entered with an Alt plus decimal value entry. 


m You can use text that forms valid cell references, column 
references, and functions. However, SuperCalc displays an 
advisory message informing you that you are attempting to 
redefine a cell, column, or function. You cannot reference 
that cell, column, or function until you delete the name. For 
example: 


If you name the range AA1:CC5 as D22, you cannot reference 
cell D22. 


If you name the cell C22 as SUM, you cannot use the 
SUM(ist) function. 


/Name, Delete 


Removes a single name from its range. The range itself replaces 
the name in formulas. 


2-126 SuperCalc Reference Manual 


/Name 


/Name,Labels 


Accepts a range from which to extract a series of names. This lets 
you name several ranges at once, from labels already in your 
spreadsheet. Specify where the labels fall in relation to the ranges 
they’re naming: 


Right The ranges fall directly to the right of their 
labels. 

Down The ranges fall directly below their labels. 

Left The ranges fall directly to the left of their 
labels. 

Up The ranges fall directly above their labels. 


The range you define must contain the names in the perimeter 
row or column that corresponds to the method selected. For 
example, if you have selected Right, then the names must be in 
the left column of the range. 


If the range consists of a single column or row, only the adjacent 
single cell is assigned to each name. 


Any cell that does not conform to the naming conventions is 
ignored with Labels, for example, nontext data, text that forms a 
number and N/A and ERROR. If text contains characters that are 
not legal for a name, they are converted to a space. 


The following spreadsheet is set up to use Labels. 


Jan Feb Mar Apr 
les 18888 12888 14808 28088 
8888 98080 11008 dogs 


ERROR 2888 3098 3898 4088 
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/Name,Labels,Right,A1:E4 Return 
E Defines SALES as B2:E2 

NW Defines COSTS as B3:E3 
/Name,Labels,Down,A1:E4 Return 
E Defines JAN as B2:B4 

NW Defines FEB as C2:C4 

NW Defines MAR as D2:D4 

E Defines APR as E2:E4 
/Name,Labels,Left,A1:E4 Return 
E Defines APR as A1:D1 

E Defines DOGS as A3:D3 
/Name,Labels,Up,A1:E4 Return 

m No named ranges defined 
/Name,Labels,Right,A1:A4 Return 
E Defines SALES as B2 


E Defines COSTS as B3 


/Name, Table 


Pulls the names and associated ranges listed in the Named Range 
Directory into a spreadsheet (see Named Range Directory in the 
next section), so that you can then print them for convenient 
reference. Two columns are written for each name defined in the 
spreadsheet, the name and the range. 
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/Name,Zap 


Deletes all range names. You are prompted for confirmation. 


Named Range Directory 


F3 The Named Range Directory displays all of 
the named ranges that are defined in the 
current spreadsheet. You can access the 
Named Range Directory from the READY, 
ENTRY, EDIT, AUDIT, or POINT modes. You 
can select from among the named ranges by 
moving the cursor. Although a name can be 
up to 32 characters, only the first 15 
characters display in the Directory entries. 
The current selection line at the bottom of the 
directory displays the full name and its 
corresponding range. 


Return Places the name of the current selection on 
the entry line. 


F4 (ABS) Places the range of the current selection on 
the entry line. When you keep pressing F4, it 
rotates the absolute cell addresses. 


Esc Exits the Named Range Directory (same as 
Backspace). 


Using Named Ranges 


You can use names anywhere that ranges are expected. Once 
you have named a range, all the formulas using that range start 
using its name. 


m If you redefine a range name using /Name, Create, all formulas 
using that name refer to its new range. To retain formula 
references to the old range, delete the name with 
/Name, Delete before giving it a new name. 
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If you redefine a range name using /Name, Labels or /Load, 
formulas using that name do not refer to the new range. 
Rather the “old name” is replaced with the “old range” when 
the new range is defined. 


A range could have more than one name. Names that define the 
same range are called synonyms. 


When you redefine a name, all its synonyms are also 
redefined. To redefine without affecting a synonym, first 
delete the name then create a new named range. 


Only the primary name (first one defined) in a group of 
synonyms displays in formulas. 


If the primary name is deleted, the next synonym defined 
becomes the primary synonym. 


Toggle Keys — Labels, Ranges 


If you use /Name,Labels or /Name, Create to create named ranges, 
F7 toggles between the label (name) and the range on the entry 
line when entering or editing formulas. 


Range example. SUM(A1:A4) F7 toggles it to SUM(SALES) 


Name example. SUM(SALES) F7 toggles it to SUM(A1:A4) 


When the row and column of each cell in a range has been 
defined as absolute, the range name displays with a dollar sign 
($) in front. For example, the formula SUM($A$1:$B$5) will 
change to SUM($TEXAS) when you define A1:B5 as the named 
range TEXAS. 
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Special Considerations 


1. Because a SuperCalc formula can contain a maximum of 240 
characters, merely redefining a range may result in a legal 
formula becoming too long to edit (if /Global, Labels is off). 


For example, if TEXAS is the name for the range A1:E5 (five 
characters), redefining TEXAS to AA1:AE5 (seven characters) 
causes the length of the formula to increase two characters for 
each occurrence. All is well — the formula will still work 
correctly — unless you edit the formula. At that time, only 
the first 240 characters will be available to edit, resulting in an 
incomplete formula. 


2. Named ranges are part of the spreadsheet. They are saved 
with /Save...All, and loaded with /Load...Replace (or All), or 
/Load...Names. Loaded names are added to the current name 
list Gf any), and thus may redefine existing names. 


3. When you use named ranges with /Load,,Part, you must 
define the names in their respective spreadsheets. 


For example, /Load,SAMPLE,Part,SALES,MYSALES requires 
that the disk file SAMPLE.cal contain a named range SALES 
and the current spreadsheet contain the named range 
MYSALES. 


Names are not loaded with a partial load. 
4. Since a name reference may be a shorthand for a range, some 


formulas with many short names may be limited to less than 
the 240 character maximum. 
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/Output 


Writes all or part of the spreadsheet to the printer or a text file on 
disk. The output can have titles, headers, footers, and margins. 
You can print multiple ranges on a single page. You can also 
preview the output on your display monitor. 


Users with certain laser printers and PostScript-compatible devices 
can apply fonts, lines, boxes, shading, and grids to individual cells 
and cell ranges with SuperCalc’s Advanced Function Printing 
(AFP) features. 


/Output, PAN Range,range 
File, filename Go 
Console 
Line-advance 
Page-advance 
Options, Quit 
Report, p Quit 
Formatted (Final/Draft/No) 
Contents, Yes 
No eet 
Highlighted 
View 
Spool,(Yes/No) 
Layout, Quit 
Page-length,value 
Width,value 
Left value 
Top,value 
Bottom,value 
Orientation, C Portrait 
Landscape 
Paper, Quit 
Wait,(Yes/No) 
Auto-page,(Yes/No) 
Double-spacing,(Yes/No) 
Line-feed,(Yes/No) 
Titles, — Auto 
Manual, — Quit 
Horizontal-range, 
range 
Vertical-range,range 


o 


None 
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Copies ,value 
Borders, — Quit 
Auto 
Yes 
No 
Character,character 
ET Quit 
fous! (1-4) string 
Fonts, — Default 


O 
i 17 
Setup,string 


Zap, 
bn 
Layout 
Paper 
Titles 
Copies 
Borders 
Headers 
Footers 
Setup 

Align 

Width,column range 

Quit 

Attributes, Quit 


Fonts, C Clear,range 
Set range, Pec 
(1-7) 
Border, r Quit 
Top, C Clear,range 
Set range 
Bottom, a Clear,range 
Set, range 
Left, $ Clear,range 
Set range 
Right, fi Clear,range 
Set,range 
Outline, — Clear,range 
[ Set, range 
Clear,range 
Shade, f Clear, range 
Set,range 
Grid, Yes 
No 
Lines, — Horizontal,range, C Single (1-5) 
] Double,(1-5) 
Vertical,range, f Single,(1-5) 
Double,(1-5) 
New-page,range 
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If you write your report to a disk file, you can use SIDEWAYS, a 
utility included with the SuperCalc program diskettes, to rotate the 
report by 90 degrees when it is printed. 


Sending your report to disk also lets you edit the report with any 
word processor that can edit an ASCII file. If your word 
processor does not read standard ASCII, check for an import 
function to read ASCII files. 


/Output,Printer 


Sends your report to the printer. The default page width is 80 
characters and the default page length is 66 lines. If your 
spreadsheet exceeds the page width, SuperCalc prints as many 
spreadsheet columns as it can on one page and prints the excess 
columns on another page. 


/Output, Printer and /Output, File have the same menu options. 
Their option definitions are combined under headings that begin 
/Output, Printer (or File). 


/Output,File 


Sends your report to a disk file on the default data drive and 
directory, or the one you specify. The report is saved on the disk 
in the same form as it appears on your console or prints on the 
printer. 


Once sent to disk, you can: 
m Print your report using the SIDEWAYS program. 


m Edit your report with a word processor (word processors 
cannot edit a .cal file). 


NW Spool your report for background printing, using the DOS 
PRINT utility. 


SuperCalc assigns the file extension .prn, unless you enter a 


different extension. SuperCalc assigns the filename of the last 
spreadsheet loaded to the print file, unless you enter a different 
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filename. Using the extension .prn differentiates the output file 
from the spreadsheet file (.ca/) on disk, keeping your spreadsheet 
file intact. 


If the filename you specify already exists, select one of these 
options: 


Backup Changes the extension of the existing file 
(.prn) to .bak and then writes your 
spreadsheet onto the disk using the .prn 
extension. Your old file remains unchanged 
and is available as a backup. Any previous 
.bak file is deleted - if you have a .bak 
backup file from your spreadsheet, the .prn 
backup will overwrite the spreadsheet 


backup. 
Change Lets you edit or change the name of the file. 
Overwrite Overwrite deletes the old version of the file 
from the disk and replaces it with the new 
file. 


.prn vs. .cal Files 


SuperCalc cannot load a pre file. Your 
spreadsheet must be saved with /Save or 
//Spreadsheets,Save or your spreadsheet will be 
lost. 


/Output, Printer and /Output, File have the same menu options. 
Their option definitions are combined under the following 
headings. 
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/Output,Printer (or File),Range 


Selects the spreadsheet range to output — the output range. 
Specify a cell range, named range, or type ALL for the entire 
spreadsheet. You must specify an output range — there is no 
default. 


Spill-over Text 


To include spill-over text (text entered in one cell 
that spills over to display in other cells) in the 
output range you must include not only the cell 
containing the text, but also all additional cells 
necessary to display the text. Range,All will not 
include text that spills-over outside of the range 
of actually occupied cells. 


SuperCalc supports multiple ranges. This means that you can 
print more than one range on a single page or print a series of 
ranges contiguously. 


To print multiple ranges on one page, you must: 
m Specify and print one range at a time. 
m Set /Output,Printer (or File), Options, Paper, Auto-page to No, 


so the printer will not do a page eject after each range is 
printed. 


/Output,Printer (or File),Go 


Generates the report and sends it to the printer or disk file. 


/Output,Printer (or File),Console 


Shows your report on-screen. On a dual monitor system, the 
preview displays on the primary monitor only. The left margin is 
ignored, and fonts, shading, borders, and lines will not display. 
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/Output,Printer (or File),Line-advance 


Sends a line feed, updating the current line count and leaving a 
blank line in your report. Enter additional blank lines by repeating 
the command. 


/Output,Printer (or File),Page-advance 


Sends a form feed (or line feeds as specified with 

/Global, Spreadsheet, Options, Formfeed); advancing to the top of 
the next page while honoring headers and footers. Repeating the 
command will add blank pages with headers and footers to your 
report. 


/Output,Printer (or File),Options 


Lets you change format and other settings on the Output Options 
Menu. The Output Options Menu displays the current output 
settings. 


OUTPUT OPTIONS MENU: (Indicates options saved with “Global ,Keep) 
*Layout ¥Paper 

Formatted Page-length 66 Wait 
Contents Width 88 ñuto-page 
Spool Left Double 

Top Line-feed 
Titles Bottom 
Horiz. N *Borders 
Vert. xCop ies Character 
Headers 


Footers 
1: 


Setup String (default) (Output range is currently empty) 


TEMP1tA1 
INTA Report Layout Paper Titles Copies Borders Headers Footers Setup 
25>/0utput Printer Options, 
ENU Exit Output Titles Menu 


This screen shows the default Output Options Menu settings. 
Items marked with an asterisk are keepable with /Global,Keep. 
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Options, Quit 


Returns you to the previous menu level. 
- Options, Report 
Defines the format and type of report. 


Quit Returns you to the main level of the Output 
Options Menu. 


Formatted Defines whether to print headers, footers, and 
titles. 
e Final — Prints titles, headers, footers, 


margins, attributes, grids, lines and 
setup string. 


E Draft — Prints titles, headers, footers, 
margins, initialization string, and setup 
string. 

e No — Prints continuously with no top 


or bottom margins. 
Contents Lets you specify the type of report generated. 


æ Yes — Lists the cell contents one per 
line. It prints the information you 
would find on the status line for each 
cell: entry level display format, 
protection status, and the cell contents. 


/Global, Labels determines if the named 


ranges or cell addresses are printed in 
formulas. 
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2 No — Outputs the spreadsheet as it 
displays on the monitor, in either value 
or formula display mode. 


/Global, Formula determines if the cell 
values or cell contents are output. 


E Highlighted — Outputs the cells 
highlighted by the most recent 
/Highlight command in //Test in the 
same format as Contents, Yes. 


a View — Outputs the spreadsheet as it 
would display on the monitor in the 
most recently selected /View mode in 
//Test. 


Spool Specifies whether to send printer control 
information, such as the setup string and 
initialization string, to a file. 


a Yes — Sends the printer setup and 
initialization strings. This file would be 
used for later background spooling to 
the printer. 


E No — Does not send the printer setup 
or initialization string. This file would 
be used for SIDEWAYS printing or 
ASCII import to a word processor. 
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Options, Layout 


Defines the page size, margins, and orientation. 


Quit 


Page-length 


Width 


Returns you to the main level of the Output 
Options Menu. 


Lets you specify the maximum number of 
lines per page. The default is 66. You can 
select 0 to 255 lines. If you specify a page- 
length of zero, the report prints continuously 
with no top or bottom margins. This is the 
same as an unformatted report. If you specify 
Top and Bottom margins, these lines are 
included in, not added to, the page-length. 


For final formatted output on an Advanced 
Function printer (AFP-supported laser printers 
and PostScript-compatible devices), SuperCalc 
determines the page size; the Page-length 
setting is ignored. 


Lets you specify the maximum number of 
characters per line. The default is 80. You 
can select 1 to 255 characters. If your 
spreadsheet exceeds the current width, 
SuperCalc prints as many spreadsheet 
columns as it can on one page and prints the 
excess columns on another page. 


For final formatted output on an Advanced 
Function printer, this value is in digits of the 
default font (for example, two Width units is 
equal to the space taken by two digits in that 
font). 
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Left ~ Defines the left margin in number of 
characters (0 to 255). The default is 4 
characters. 


For final formatted output on an Advanced 
Function printer, this value is in digits of the 
default font and is in addition to the 
unprintable area that the printer hardware 
leaves on the left side of the page (about 1/6" 
on a Hewlett-Packard LaserJet, for example). 


Top Defines the top margin in number of lines (0 
to 255). The default is 2 lines. 


For final formatted output on an Advanced 
Function printer, this value is in lines of the 
default font, in addition to the area the printer 
hardware leaves on the top and bottom 
(about 1/5" on a Hewlett-Packard LaserJet). 


Bottom Defines the bottom margin in number of lines 
(0 to 255). The default is 2 lines. 


For final formatted output on an Advanced 
Function printer, this value is in lines of the 
default font, in addition to the area the printer 
hardware leaves on the top and bottom 
(about 1/5" on a Hewlett-Packard LaserJet). 


Orientation If you have selected a printer with advanced 
functions, these options may be available to 


print the report either upright or sideways. 


2 Portrait — Prints the report in the 
standard upright orientation. 


ES Landscape — Prints the report 
sideways. 
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Options, Paper 


Lets you control the paper in your printer. 


- Quit Returns you to the Output Options screen. 
Wait Lets you select whether to print continuously 


or pause printing between each page. 


% Yes — Stops printing between each 
page. Press the Spacebar (or any key) 
to begin printing the next page. This is 
especially useful with single sheet 


feeders. 
& No — Does not stop printing between 
pages. 
Auto-page Lets you select whether to do a page eject 


after each range printed. This is called Top- 
of-Form on some printers. 


® Yes — Does a page eject after each 
range. 
a No — Does not eject the page after 


each range. This allows you to print 
multiple ranges per page. 


Double- Lets you print a double-spaced or single- 
spacing spaced report. 
# Yes — Prints a double-spaced report. 
= No — Prints a single-spaced report. 
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Line-feed Lets you select the end-of-line character(s) to 
match your printer. 


g Yes — Sends a line feed (0A Hex), in 
addition to a carriage return (0D Hex) 
at the end of each line. On some 
printers this gives you a double space 
after each line. 


s No — Sends only a carriage return at 
the end of each line. 


Options, Titles 


Sets whether either or both horizontal and vertical titles are 
printed with your report. You can pull the titles automatically 
from the spreadsheet (as defined by /Title) or independently. 
Titles print on each page of the report, inside the border, just as 
they appear on a spreadsheet. 


Auto Takes the titles from the spreadsheet as 
defined by /Title. 


Manual Lets you define the title ranges independent 
of /Title. Whereas /Title defines titles from 
only the top-most rows or left-most columns, 
Manual allows you to define title ranges 
anywhere in the spreadsheet. 


s Quit — Returns you to the main level 
of the Output Options Menu. 


G Horizontal-range — Defines the 
horizontal titles. 


2 Vertical-range Defines the vertical 
titles. 
None Does not include titles with the report. 
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Options, Copies 


Lets you select the number of copies to print, from 1 to 99. 


Options, Borders 


Lets you select whether you want a border printed showing the 
column letters and row numbers and specify an alternate border 
character to use in place of the vertical bar. 


Quit Returns you to the main level of the Output 
Options Menu. 


Auto Prints the borders only when the border is set 
to display on screen (with /Global, Border). 


Yes Prints the border, regardless of whether the 
border displays on screen. 


No Does not print the border, regardless of 
whether the border displays on screen. 


Character Lets you type in a new border character. This — 
is useful if your printer cannot print the 
vertical bar (|) character. The colon (:) is a 
good alternative border character. 


This field is ignored for Advanced Function 
printing. 
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Options, Headers (or Footers) 


You can specify up to four headers and four footers. Each can 
have up to 255 characters. The header and footer lines scroll to 
the left when longer than the screen can display. 


Quit Returns you to the main level of the Output 
Options Menu. 


1, 2, 3, 4 Lets you select one of the four available 
header or footer lines to enter text. 


Fonts Lets you assign a font to headers/footers. 


3 Default — Uses the standard font to 
print headers/footers. 


E 1 - 7 — Assigns one of the available 
fonts (set with 
/Global, Spreadsheet, Fonts) to all 
headers/footers. 


Active headers and footers are determined by the last one defined 
in each group. SuperCalc prints only active headers and footers. 
For example, if you have defined only headers one and two and 
have left headers three and four empty, the program allocates two 
lines to those headers. On the other hand, if you do not define 
headers one and two but define header three, it allocates three 
lines — two empty lines and a third line containing header three. 
Header and footer lines are included in, not added to, the page- 
length. 


These characters have special meaning in a header or footer: @1 
- @8 print the DOS date in the specified user-defined format; @F 
prints the short filename (without drive or directory); @L prints 
the long filename (with drive and/or directory); @P prints the 
current page number. To print the @ character in a header or 
footer, type the character twice. Use l:: and ::| to enclose setup 
strings within headers or footers. The vertical bar (|) separates 
left-, center-, and right-justified portions. For example, enter the 
string as left portion | center portion | right portion for a 
three-part header, |center portion for a centered header, or 
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| lright portion for a right-justified header. Chapter 1 also 
contains information on using setup strings within 
headers/footers. 


Options, Setup 


Lets you enter printer control instructions (setup strings) that can 
be sent at the beginning of output to specify type fonts, draft or 
letter quality output, and other appearance features. See your 
printer manual for information on controllable features and 
applicable control codes. 


The maximum number of characters is 240. You may enter either 
the control characters (CtrH0) or their decimal equivalent values 


(in this case, \015). 


When entering printer control codes, the Edit mode cursor keys 
are available. 


To enter Return as a printer control code, type \013. 
To enter Del as a printer code, type \127. 
Characters from the extended ASCII set may be typed as \128 


through \255, or on some keyboards they may be typed with Alt 
plus the decimal value. 
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/Output,Printer (or File),Zap 


Displays the Output Options Menu. Select an option from the 
menu to reset that option to its Keep value (shipped defaults, or 
values last saved with /Global, Keep). See the Option sections 
above for a description of each option: Report, Layout, Paper, 
Titles, Copies, Borders, Headers, Footers, Setup, and Initialization. 
All resets all output options. 


/Output,Printer (or File),Align 


Resets printer line and page counters. Adjust tractor-fed paper, 
then select this when starting a new document as the final step 
before Go. 


/Output,Printer (or File),Width 


Tells you the width of a specified range, in characters. You may 
want to use this information to set the page width for a report. 
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Advanced Function Printing 


/Output, Attributes, Lines, and Grid are available for use if you 
have a printer that supports Advanced Function Printing. 
‘Supported printers include PostScript-compatible devices and 
certain laser printers. 


When set, these features don’t display on your screen. To check 
their location before printing use //Test (see Appendix B). 


/Output,Attributes 


Lets you define fonts, borders, and shading in your report. 


/Output,Attributes,Fonts 


Lets you apply fonts to individual cells or ranges. You can use up 
to eight fonts in your report. Use /Global,Spreadsheet, Fonts to 
define them. 


Fonts, Clear 


Removes applied fonts from the selected range. 


Fonts, Set 


Applies one of eight fonts to the selected cell or range. 


Default Applies the standard font to the specified 
range. 

1-7 Specifies the font number (as defined with 
/Global, Spreadsheets, Fonts) to apply to the 
range. 
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/Output,Attributes, Border 


Places border lines on the specified range. 


Quit Returns you to the main Attributes menu. 
Top Places or removes a horizontal line above 


each cell in the range. 


Bottom Places or removes a horizontal line below 
each cell in the range. 


Left Places or removes a vertical line to the left of 
each cell in the range. 


Right Places or removes a vertical line to the right 
of each cell in the range. 


Outline Places or removes a border on all four sides 
of the specified range. 


Clear Removes any applied borders from the 
specified range. 


/Output, Attributes, Border Options 


The Border commands Top, Bottom, Left, Right, and Outline each 
have the following options: 


Clear Removes any applied border from the 
specified range. 


Set Places the border in the specified range. 
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/Output,Attributes,Shade 


Places a light shading over the specified range. 


Shade, Clear 


Removes all shading from the specified range. 


Shade, Set 


Places shading over the specified range. 


/Output,Grid 


Places horizontal and vertical lines on all four sides of every cell 
in the output range. The lines around the outside border of the 
range are heavier than the interior lines. 


Yes Places a grid on the output range. 
No Removes a grid from the output range. 
/Output,Lines 


Places control text for drawing lines into cells in the specified 
range. Options include horizontal or vertical lines, and selections 
for line shading and line thickness. 


/Output,Lines,Horizontal 

Places control text for drawing a horizontal line into cells. 

First, enter the range where you wish to draw the line. Control 
text is placed in each cell in the range. More than one line can be 
drawn in a single row. 

Next, select from the following options: 


Single Defines a single line across each row. 


Double Defines a double line across each row. 
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You may select one of the 5 predefined line styles. 
You may also directly enter or edit the control text to draw lines 
in each cell. The control text for a horizontal line is in the 


following format: 


|:- row height,line-shading,base-line offset,line 
thickness,base-line offset,line thickness.... 


where: 


m |:- specifies the control text to draw a horizontal line. 


= Row height specifies the distance in decipoints from the 
bottom of the row above the cell to the bottom of the cell 
(the baseline of that row). There are 720 decipoints to an 
inch. 


A row height value of 0 indicates that the current row height 
(defined by the tallest font within the row) should be used. 


E Line-shading specifies the percentage of shading from 0 to 
100 where 100 is fully shaded or black. 


Ææ Base-line offset specifies the relative location within the row 
to begin drawing the line. The distance is measured from the 
bottom of the row-height in percentages (50 percent will 
begin to draw the bottom of the line in the exact center of the 
row) and the line is drawn upward from this location. 


m Line thickness specifies the thickness of the line as a 
percentage of the row-height (25 percent will draw a line 1/4 


of the distance of the row-height). 


The base-line and line thickness may be repeated within the 
control text to draw additional lines of the same shading. 
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For example, the control text: 
| :-720,100,0,25,50,10,75,25 


will draw three black lines (100% shaded) in a row that is one 
inch high (720 decipoints). The first line will be at the very 
bottom of the row (0) and will be 1/4 inch thick (25% of 720 
decipoints). The second line will begin in the middle of the row 
(50) and will be 1/10 inch thick (10% of 720 decipoints). The third 
line will begin 3/4 of the distance up the row (75) and will 1/4 
inch thick (25). 


If the control text for a horizontal line specifies only the row 
height, SuperCalc will use this height for the entire row, even if a 
font in the row sets a larger or smaller height. 

Row height is always determined by scanning an entire row -- not 
just the output range. This control text need not occur within the 
output range. /Output, Lines control text can be used to force a 


line height for a range of lines. For example, |:-360 will print a 
blank row one-half inch high. 


/Output,Lines,Vertical 

Places control text for drawing a vertical line into cells. 

First, enter the range where you wish to draw the line. Control 
text is placed in each cell in the range. More than one line can be 
drawn in a single column. 

Next, select from the following options: 

Single Defines a single line down each column 


Double Defines a double line down each column 


You may select one of the 5 predefined line styles. 
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You may also directly enter or edit control text to draw lines. The 
control text for a vertical line is in the following format: 


|: col-width,line-shading,base-line offset,line width,base- 
line offset,line width.... 


where: 


m |:| specifies control text for a vertical line. 


E Col-width specifies the distance in decipoints from the 
column to the left of the range, to the column following the 
range. There are 720 decipoints to an inch. An entry of 0 uses 
the current column width. Any other entry will override the 
actual column width set with /Format for this row. 


A value other than 0 should be used with care, and would 
normally only be used if all cells in this column of the output 
range contain the same value. 


E Line-shading specifies the percentage of shading from 0 to 
100 where 100 is fully shaded or black. 


m Base-line offset specifies the relative location within the 
column to begin drawing the line. The distance is measured 
from the left of the column in percentages (50 percent will 
begin to draw the line in the exact center of the column) and 
the line is drawn to the right from this location. 


= Line width specifies the width of the line as a percentage of 
the col-width (25 percent will draw a line 1/4 of the width of 
the col-width). 


The base-line and line thickness may be repeated within the 
control text to draw additional lines of the same shade. 


SuperCalc Commands 2-153 


/Output 


For example, the control text: 
|: 1720,100,0,25,50,50 


will draw two black lines (100% shaded) in a column that is one 
inch wide (720 decipoints). The first line will begin at the very left 
of the column (0) and will be 1/4 inch wide (25). The second line 
will begin in the middle of the column (50) and will be 1/2 inch 
wide (50). 


/Output,New-page 


Inserts a line in the spreadsheet and places page break commands 
in the body of your report. The break occurs above the break 
symbol (I::). If any data is later entered on the same row as the 
page break, the data will not be printed. 


You can manually enter the symbol (vertical bar, colon, colon) 
instead of giving the New-page command, if you prefer. 


Saving and Keeping Output Options 


There are three ways that a value can be changed from the 
default value: (1) You change it at /Output,, Options, (2) You load 
a spreadsheet where the default value was changed and saved 
with /Save, //Spreadsheets, Save, or /Global, Keep, or (3) You use 
/Global, Keep, From to load a configuration file containing different 
value settings. All changes to the Output Options Menu and 
Attributes settings are saved with the spreadsheet. 


When you use /Global, Keep, only those options marked with an 
asterisk are kept. (Keep modifies the SuperCalc program file and 
includes the File List, Global Graphics, and Optimum menus.) 


Those values on the Output Options Menu that have been 
changed from the default values are highlighted. Highlighted 
values are saved explicitly with the spreadsheet, overriding any 
Keep values. Non-highlighted values are not saved explicitly. This 
means that for non-highlighted values, if you save a spreadsheet, 
and later change the Keep setting, when you load the spreadsheet 
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the new Keep value will be in effect. Thus, if you want to save a 
value with the spreadsheet, you must define it, even if it has the 
same value as the Keep value. 


Examples 


E Output report to the printer: 
/Output, Printer, Range, ALL, Go. 


NE Output report of column B to printer, changing to print cell 
contents: 


/Output, Printer, Range, B, Options, Report, Contents, Yes, 
Quit, Quit, Go. 


m Change page width, then output to a disk file in a format that 
can be edited by a word processor. 
/Output, File, B: WORK 1, Range, A 1:J23, Options, Layout, 
Width,65 Return Quit, Quit, Go. 


m To send the initialization string CtrlO (sets some printers to 
print compressed type) to your printer each time you print: 


/Output, Printer, Options, Setup, Ctr-O Return. 


Graphics Output 


You cannot use /Output to plot a chart or a chart descriptor. See 
the //Graphics command section for instructions on printing or 
plotting a chart. 
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/Protect 


/Protect prevents any changes to cell contents in a specified 
range, and prevents any changes to empty cells formatted at the 
Entry level. 


/Protect, E (current cell) 


range 


If you select /Protect and press Return without entering a range, 
only the current cell will be protected. There is no error message 
if you attempt to protect cells that are already protected. 


You cannot copy or load onto protected cells. The commands 
operate normally on surrounding cells but leave the protected 
cells unchanged. 


/Delete does not delete any rows, columns, or blocks containing 
protected cells. /Blank does not blank protected cells within the 
specified range. /Zap and //Spreadsheets, Zap override protected 
cells to delete the entire spreadsheet. 


/Unprotect removes protection from a specified range. Use 
/Global, Protection to temporarily toggle the shield of protection 
on and off. Use /Global, Unprotected to indicate the initial state of 
a cell (Unprotected or Protected). 


On some monitors, protected cells are distinguished from 
unprotected cells by color or intensity. 


Chapter 4 of the User's Guide tells more about using /Protect. 
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/Quit 


/Quit lets you exit from SuperCalc to the operating system or to 
another program (.com program type). You can also exit 
temporarily to the operating system and then return to your 
spreadsheet. 


/Quit, r No 

Yes 

To, program name (must be .COM file) 
If name found: | 


Save, filename į , r Backup 


Overwrite 


DOS 


After you give the /Quit command, a reminder message will 
display if you have modified the file but have not saved it. If you 
need to save your current spreadsheet, choose /Quit,Save to save 
changes before leaving SuperCalc. 


With multiple spreadsheets in memory, /Quit closes the current 
spreadsheet and displays the next. You can leave the program if 
only one spreadsheet is in memory with /Quit, with multiple 
spreadsheets in memory, use //Spreadsheets, Quit. 


/Quit,No 


Cancels the /Quit command and returns you to SuperCalc. You 
can also cancel the /Quit command by pressing Ctrl-Break. 


/Quit, Yes 


Returns you to the operating system. The spreadsheet is erased 
from the computer’s memory. Choose /Quit,Save to keep recent 
chages. If there are several spreadsheets in memory, /Quit, Yes 
quits to the next spreadsheet (in order of the Open Spreadsheets 
Directory). 
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/Quit,To 


/Quit, To lets you go directly from SuperCalc to another program. 

Specify the name of the file you want to run (precede the name 

with-a disk drive and directory, if necessary). Pressing F3 

displays the File List. er 


File Types 


This works only for a .com program file. Other 
DOS executable programs, such as .exe and .bat 
do not work. Also, merely renaming an .exe file 
to a .com file will not work. 


/Quit,Save 


Saves the current spreadsheet before quitting. Use /Quit,Save if 
you see a reminder to save recent changes when you select /Quit. 
You're prompted to Backup or Overwrite if the file already exists. 


/Quit,DOS 


Sends you to the operating system, temporarily. Typing Exit 
returns you to the current SuperCalc spreadsheet. 
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/Save 


/Save writes the current spreadsheet, including chart descriptors, 
onto a disk file while retaining it in computer memory. Options 
give a choice of saving all or part of the spreadsheet, only the 
calculated value of each cell, or only protected or unprotected 
cells. Files can also be saved in formats compatible with 
SuperCalc3, SuperCalc4, and Lotus 1-2-3. 


- spuew 


Use //Spreadsheets, Save to save all spreadsheets in memory. Also 
see /Quit, Save, //Spreadsheets, Quit, Save, /Zap, Save, and 
//Spreadsheets, Zap, Save for other ways of saving your spreadsheets. 


If name found: 


/Save, filename |, — Backup , m All 
- Change Values 
Overwrite Part, All, from range 
L Values, from range 
Duplicate 
Level, sc5 
- sc4 
sc3 
Mode, - All 
- Protected 
Unprotected 
Single, > All 
Values 


Part, 3 All, from range 
Values, from range 
Duplicate 
Level, sc5 
i sc4 
sc3 
Mode, All 
i Protected 
Unprotected 


Select /Save, then enter the name of your file. SuperCalc appends 
the file extension defined with /Global, Optimum, Present, 
Extension (.cal, .wk1, or .wks) to the file unless you specify 
another. The default, .cal, or any extension other than .wk1 or 
wks saves in SuperCalc format. 
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seis Zz a 


/Save 


SuperCalc saves the file on the default data drive/directory unless 
you specify another. The entry line displays the default filename. 
Press Return to accept that name, or press F3 to access the File 
List. To edit the filename, press F2. Or, simply start typing the 
new name. 


If you change the name to be different from the current 
spreadsheet name, selecting /Save,A// will rename the current 
spreadsheet in memory. Any other /Save option will leave the 
current spreadsheet name as it is. 


If the file already exists, SuperCalc displays the following options: 


Backup Changes the extension of the file residing on 
disk to .bak, then writes the current 
spreadsheet to a disk file with the default or 
typed extension. Your old file remains 
unchanged and is available as a backup. Ifa 
.bak file already exists, it is deleted 
permanently from the disk. 


To load a .bak file, you must specify the .bak a 
extension. 

Change Lets you edit or change the name of the file. 

Overwrite Erases the old file from the disk and creates a 


new file of the same name containing your 
current spreadsheet. Use with caution! 


You then specify the part of the file to save. 
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/Save Options 


/Save,All 


Saves the entire file on disk. It saves the cell contents, cell values, 
and display formats. It also saves some of the global toggle and 
calculation options, title locking, window splitting, current cursor 
location, and non-default output settings. All saves all pages of 
the current spreadsheet. 


If you save the file under a name that is different from the current 
spreadsheet name, the current spreadsheet is renamed in memory. 
To save a file under a different name without renaming the 
current spreadsheet, use /Save, Duplicate. 


/Save,Values 


Saves the cell values as numeric constants. It also saves display 
formats. It does not save the cell contents, such as formulas. 
Values saves all pages of the current spreadsheet. 


/Save,Part 


Saves the portion of the spreadsheet you specify: 


All Saves all the cell data for the range you 
specify. 
Values Saves only the values for the range you 


specify. Dates are stored as their DVAL 
function value, times as their TVAL function 
value. 


/Save,Level 


Indicates the file is to be saved in a format compatible with 
SuperCalc3 or earlier, SuperCalc4, or this version (which is the 
default). 


/Save, Level does not initiate the save; continue with All, Values, 
Part or Duplicate to save the file. 
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When you save to an earlier version of SuperCalc, it saves only 
the specified file to that format; subsequent /Save commands 
revert to the default. 


/Save,Level,sc5 


Indicates the file is to be saved in SuperCalc version 5.0 format. 


/Save,Level,sc4 


Indicates the file is to be saved in SuperCalc4 format. 


/Save,Level,sc3 


Indicates the file is to be saved in a format compatible with 
SuperCalc3 and earlier versions. 


/Save,Mode 


Determines the type of cells that will be saved: All, Protected, or 
Unprotected (All is the default). /Save,Mode does not initiate the 
save; continue with All, Values, Part or Duplicate to save the file. 


When you change the mode to Protected or Unprotected, it affects 


only the current save. Future /Save commands revert to the 
default, AŻ. 


/Save,Mode, All 


Sets the mode to save all of the spreadsheet. 


/Save,Mode,Protected 


Sets the mode to save only protected cells. 


/Save,Mode,Unprotected 


Sets the mode to save only unprotected cells. et 
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/Save,Single 


Saves a single page of a multipage spreadsheet, as a separate 
spreadsheet. 


/Save,Duplicate 


Saves the entire file on disk without changing the current 
spreadsheet name. 


Use this option when you want to save a copy of the current 
spreadsheet under a different name without renaming the current 
spreadsheet. To automatically rename the current spreadsheet in 
memory, use /Save,All instead of /Save, Duplicate. 


Examples 
Save the entire file: 


/Save, WORKS, All 


Save the values of the spreadsheet on drive B: 


/Save,B: WORKS, Values 


Save the file in a format that can be read by SuperCalc3: 
/Save,B:WORKS,Level,sc3,All 
Save entire file to a directory REPORTS in this path: 


\LETTERS\ REPORTS (the current data directory may be on a 
different path): 


/Save,\ LETTERS \ REPORTS, WORKS5,Al| 


Save a file in a Lotus 1-2-3 file format: 


/Save, WORK5.wk1,All 


Special Considerations 


1. For the Overwrite option, SuperCalc deletes an existing file 
permanently from the disk. 
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2. /Save writes the file in binary format on the disk. That is, the 
file is readable by the SuperCalc program, but not by other 
programs, such as word processors. However, most word 
processors can edit a spreadsheet written to disk with the 
/Output, File command. 


3. Use the //Export command to write a spreadsheet in comma 
separated value format (.csv file). The .csv file can be edited 
by any program that uses comma separated values, such as a 
BASIC program or most word processors. 


4. If your spreadsheet size exceeds the space available on your 
data disk, the program issues a Disk Full message. If so, save 
the spreadsheet in two or more parts (separate files), using 
the /Save...Part command. You can reunite the parts with the 
/Load...Part command, but use the /Load...All command 
when loading the first file (this loads the global formats for 
the entire spreadsheet). You can also design an lautoexec 
macro to load several parts of a large spreadsheet. 


5. To save a file in a data format useable by programs other 
than SuperCalc, use the //Export command. Refer to the 
//Export section of this chapter for more information. 


6. You can save Lotus 1-2-3 .wk1 and .wks files by specifying 
that extension as part of the filename. If you'll be saving a 
number of these files, use /Global, Optimum, Present, 
Extension to set the appropriate extension default type. 
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/Title 


/Title locks columns and rows on the display window so that they 
continue to provide labels and other reference information while 
you are scrolling the remainder of the screen. 


Vertical 
Both 
Clear 


/Title, : Horizontal 


These rules apply: 


Æ A horizontal title lets you scroll vertically and still see the 
locked row(s). 


m A vertical title lets you scroll horizontally and still see the 
locked column(s). 


Æ Locking both column(s) and row(s) lets you scroll any 
direction and still see the locked areas. 


m Specifying a new title lock replaces a prior one. 


m The cursor movement keys cannot move the cursor into a 
locked title; use F5 or Home to do this. 


Chapter 4 of the User’s Guide tells more about using this 
command. 


/Title,Horizontal 


Locks the current row and all rows above it. 


/Title,Vertical 


Locks the current column and all columns to the left of it. 
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/Title,Both 


Locks the current row and column and all rows above and 
columns to the left. 


/Title,Clear 


Removes any title locks. 
SuperCalc clears a title lock automatically when you: 


m Press F5 and go to a locked cell that is off-screen (above a 
locked row or left of a locked column). 


m Use /Window and the locked row or column is pushed off- 


screen. 


Printing Titles 


You can print with the locked titles by selecting /Output, Options, 
Titles, Auto. 
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/Unprotect 


/Unprotect removes cell protection applied with the /Protect 
command. 


/Unprotect, J (current cell) 


range 


There is no error if you try to unprotect cells that are not 
protected. 


If you select /Unprotect, then press Return without entering a 
range, only the current cell will be unprotected. 


You can use /Global, Protection to temporarily toggle all 
protection on and off. 


You can use /Global, Unprotected to indicate the initial state of a 
cell (Unprotected or Protected). 


Chapter 4 of the User’s Guide tells more about using this 
command. 
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/Window 


/Window splits the display window into two separate parts, either 
horizontally or vertically. This command uses the current row or 
column to determine where to split the display. You can move 
the cursor between windows with F6. 


/Window, — Horizontal 
Vertical 
Clear 
Synchronize 
Unsynchronize 


Each window can have separate /Global options settings and 
/Format options settings at the Global level (not at the Column, 
Row, or Entry levels). SuperCalc can display the same cell in each 
window with different /Format or /Global display options 
(Formula, Border, Next, and Tab). This lets you see a 
spreadsheet region as formulas and values simultaneously. 


If you use /Global, Keep when the screen is split, SuperCalc retains 
the keepable defaults that apply to the current window only. 


Each window of a split-screen display has its own /Title lock 
specification. When you split a screen, SuperCalc retains any 
meaningful lock in both windows. 


/Window can be used within each screen division created with 
//Spreadsheets, Display to create up to six “panes” on screen at one 
time. 


You can save your spreadsheet with the windows set, but you 
cannot output it showing both windows. You can print any or all 
of the spreadsheet, regardless of which window contains the 
current cell. However, the window containing the cursor controls 
the print display format. 


For more information on using /Window, see Chapter 4 of the 


User’s Guide. For a related command, see //Spreadsheets, Display 
in this chapter. 
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/Window,Horizontal 


Splits the screen into two sections, top and bottom. The current 
row moves down and the new border replaces it. The current 
cell moves down into the newly created window. 


/Window, Vertical 


Splits the screen into two sections, left and right. The current 
column moves right and the new border replaces it. The current 
cell moves right into the newly created window. 


/Window,Clear 


Removes the split screen. The window that is above or on the 
left displays in full. The global display options for that window 
remain in effect. 


/Window,Synchronize 


Causes both windows to scroll simultaneously when the cursor 
moves parallel to the split. 


/Window,Unsynchronize 


Causes each window to scroll independently. 
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/Zap 


Erases a spreadsheet from memory, leaving a blank display 
window. The “zapped” file is not erased from disk. 


Zap, - No 
Yes If name found: 
Save, filename Y , m Backup | 
Overwrite 
Page 
/Zap,No 


Cancels the command and returns to the spreadsheet. 


/Zap,Yes 


Erases all the cell contents and resets the display format to the 
default settings for the entire spreadsheet. 


m Resets the User-Define Date and Number settings to the 
/Global, Keep settings. 


m Overrides protected cells — they are zapped. 
MN Deletes all current charts. 

NH Deletes all named ranges. 

m Clears windows and title locks. 


m Resets the Output Options Menu settings to the /Global, Keep 
settings. 
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Zap does not clear these session-related settings: 
@ Default data directory. 
m /Global, Optimum settings. 


E //Graphics,Global settings. 


/Zap,Save 


Saves the current spreadsheet before erasing it. It will prompt 
you to Backup, Change, or Overwrite the existing disk file, if 
found. 


Choose /Zap, Save if recent spreadsheet changes have not yet 
been saved. 


/Zap,Page 


Zaps the current page of a multipage spreadsheet. /Zap,Page 
erases cell contents for the current page, and resets the display 
format to the default settings. 


Special Considerations 


1. /Zap and /Global, Protect are the only commands that override 
cell protection. 


2. It is a good practice to use /Zap or /Load, Replace when 
changing spreadsheets, instead of just loading a new 
spreadsheet on top of the old one. 


3. If you use /Zap, Yes on a multipage spreadsheet, all pages are 
zapped and only one page remains open. Use /Zap, Page to 
clear only the current page of a multipage spreadsheet. You 
can use //Spreadsheets, Zap to clear all spreadsheets in 
memory at once. See Chapter 10 of the User's Guide for 
details. 
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/1-2-3 


/1-2-3 (execute single Lotus 1-2-3 command) 


/1-2-3 lets you issue a SuperCalc command through the Lotus 
1-2-3 menu tree. After issuing the command, SuperCalc menus 
are restored. 


Use /Global, 1-2-3 to toggle “Lotus Compatibility mode.” All 
subsequent commands will be interpreted through the Lotus 1-2-3 
menus until you return to SuperCalc menus with /Worksheet, 
Global,sc5. 


You may also wish to change default protection to emulate 1-2-3 
default behavior. Use /Global,-Protection and 
/Global, -Unprotected. 


When working in Lotus Compatibility mode, /sc5 lets you execute 
a single command through the SuperCalc menus. 
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//Add-in 


//Add-in attaches, invokes, and detaches compatible add-in 
programs and functions for use with SuperCalc. You can assign 
add-in programs to function keys so that you can quickly invoke 
them, and specify one add-in program to activate automatically 
when starting SuperCalc (auto-invoke). Once made, you can save 
//Add-in settings with /Global, Keep, Yes. They will be stored in a 
file called ADN.cfg. (SuperCalc will automatically use this file if it 
exists. ) 


//Add-In, > Attach, filename, — None,(No/Yes) 

1,(No/Yes) 
2, (No/Yes) 
3, (No/Yes) 
4 (No/Yes) 
5,(No/Yes) 
6,(No/Yes) 
7 (No/Yes) 
8, (No/Yes) 
9 (No/Yes) 
0,(No/Yes) 

Detach, filename 

Invoke, filename 

Zap,(No/Yes) 

Quit 


//Add-in displays the Add-in List, showing all attached programs 
and functions. The menu displays the following options: Attach, 
Detach, Invoke, Zap, Quit. 


//Add-in, Attach 


Makes an add-in application or function available; loads the add- 
in into memory. Add-ins must be attached before they can be 
invoked. 


When the filename prompt displays, type the name of the 


program or function you are attaching, including the drive and 
directory. You can also press F3 to select from the File List. 
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//Add-in,Attach, 1-0 


You can you assign an add-in to a function key (F1 through F10), 
so that you can invoke the add-in simply by pressing Shift plus 
_that function key. 


//Add-in,Attach,None 


None assigns no function key to the add-in. Select None when 
attaching an add-in function; once attached, they are invoked 
automatically whenever they are used in a formula. 


Auto-invoke 


After specifying the filename and function key, you can indicate 
whether you want this add-in program to automatically invoke 
whenever you start SuperCalc. Only one add-in program can be 
auto-invoked. 


No The program must be invoked by command 
or function key. 


Yes The program is automatically invoked when bee 
you start SuperCalc. 


Add-in functions cannot be auto-invoked. 


//Add-in,Detach 


Removes selected functions or programs from memory. When 
you detach a program or function, it is no longer available for use 
by SuperCalc. 


//Add-in, Detach prompts for the name of the program or function 


you are removing from memory. You can select the filename 
from the Add-in List, or enter it. 


//Add-in, Invoke > 


Activates attached programs. 
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//Add-in, Invoke prompts for the name of the program you are 
invoking. You can select the filename from the Add-in List, or 
enter it. 


//Add-in,Zap 


Removes all add-in programs and functions from memory, so they 
are no longer available for use by SuperCalc. 


When Zap is selected, SuperCalc prompts you to verify if you 
want to remove (detach) all the add-in programs and functions. 


No Does not detach all the add-in programs and 
functions from SuperCalc, and returns you to 
the //Add-in options. 


Yes Detaches all the add-in programs and 
functions from SuperCalc. 


//Add-in,Quit 
Returns you to READY mode. 
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//Data 


Lets you locate and analyze specific data in a spreadsheet. 


//Data, 


Quit ho 
Input,range 
Criterion,range 
Output, range 
Find, (for next record) 
(for previous record) 
(for next field) 
(for previous field) 
to end 
Extract 
Unique 
Select, Yes 
No 
(for next field) 
(for previous field) 
to end 


Remain 
Delete, Yes 
No 
Remaining => 
(for next record) 
(for previous record) 
to end 
Analysis, a Distribution,input range,bin range 
Regression, - Go 
X-Range,range 
Y-Range,range 
Output,range 
Fit,(Linear/Quadratic/Cubic) 
Intercept,(Calculate/Zero) 
Zap 
Quit 
Block,range, - Number, start value step value stop value (€ 
Growth,start value step value stop value Ce 
Date, p Day, start value step value 
stop value 
Week, start value step value 
stop value 
Month,start value step value 
stop value 


Order, - Column 
Row 
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Invert,rangel, output range 
Solve,rangel output range 
Parse, Go 
Create,cell 
Edit, cell 
Input, column range 
Output, column range 
Zap 
Quit 
Table, - 1 table range, input cell 


Matrix, L Multiply, range 1,range2, output range 


2, table range, input celll input cell2 
Zap 


With these commands, you can: 


m Specify a range of cells containing data records to be 
searched. 


m Locate, copy, or delete records in the database that match 
your selection criteria. 


Analyze the distribution of data or create a regression analysis 
on the data. 


NW Generate data within a specified range. 

Æ Multiply, invert, or solve matrixes. 

m Parse or break out a set of fields from lines of text. 

m™ Prepare value tables for one- and two-variable test formulas. 
When combined with SuperCalc's powerful multi-key dictionary 
sort (/Arrange), the data management commands help you 
organize, analyze and find your data with great ease and 
accuracy. 

To access the data management and analysis commands, select 
//Data. These options display: Quit, Input, Criterion, Output, 


Find, Extract, Unique, Select, Remain, Delete, Analysis, Block, 
Matrix, Parse, and Table. 
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Data Management 


When you use a data management option (Input, Criterion, 
Output, Find, Extract, Unique, Select, Remain, or Delete), 
SuperCalc returns you to the //Data menu instead of READY 
mode. You can select another //Data option, or exit by selecting 
Quit or Remain. 


The data management options are related in this way: 


mM Input defines the input range, containing field names and 
data records. Options Find, Extract, Unique, Select, and 
Delete work on data within the input range. 


MH Criterion defines the criterion range, containing the names of 
fields to be used as selection keys and the criteria to be 
matched within each field. Find, Extract, Unique, Select, and 
Delete select data for their operations according to the 
instructions provided by these criteria. 


m Find, Extract, Unique, Select, and Delete indicate the database 
operation to be performed: location, copying, or deletion of 
records that match the selection criteria. 


E Output defines the output range, where copied records 
display after you use Extract, Unique, or Select. 


The next sections describe the operations performed by each of 
the data management options. Data management details follow 
the option description sections. 


//Data,Quit 


Returns to READY mode. The cursor returns to the cell it 
occupied before you entered //Data (see //Data, Remain). 
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//Data,Input 


Specifies the range of cells that contains the records and fields for 
the data management options. When you select //Data,Input, the 
currently defined range displays. 


The first row of the input range contains the field names, which 
must be text. If you omit the field names in the input range, you 
must leave a blank first row in the input range; the criterion 
range’s first row must also be blank. SuperCalc will then ignore 
any field names used in the criterion range. The program begins 
searching for the data in the second row of the input range. 


For example, an input range might look like this: 


LEVEL BILLING — Field Names 


Senior 16466 
Staff 756 + Records 
Staff 788 


You must define the input range before you use //Data, Find, 
Extract, Select, Unique, or Delete. 


//Data,Criterion 


Specifies the range of cells where the selection criteria are stored. 
When you select //Data, Criterion, the currently defined range 
displays. 


You can specify the criterion range either before or after you have 
entered selection criteria into the spreadsheet. The range must 
indicate the exact number of rows in the criterion range. If one 
of the rows specified is blank, the program will highlight or 
extract data from all the records in the input range. However, 
you may specify more columns as long as they are blank — this 
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//Data 


gives you more flexibility in adding or removing fields when you 
change your criteria. 


You must define a criterion range and enter your criteria in the 
designated range before you use //Data,Find, //Data, Extract, 
//Data, Select, //Data, Unique, or //Data, Delete. 


Entering Selection Criteria 


Criterion Fields — The first row of the criterion range is 
reserved for the names of the fields you want to use as search 
keys. For example, if you want to extract records based on zip 
codes within counties, the only fields you enter in the criterion 
range are COUNTY and ZIP_CODE. 


If the field names of the criterion range do not match any of the 
input range field names, no records will be found. For a global 
search of all fields you can omit the field names, leaving the first 
row of the criterion range blank (SuperCalc searches the entire 
input range for matches). This is a quick way to search for one 
or more occurrences of a data value, name, or date, regardless of 
its position in the database input range. 


Search Criteria — Under each field name, you enter the search 
criteria. The criteria you enter under each field name can match 
numbers or text. In either case, the match can be exact, 
nonselective, or selective. 


1. An exact text-match entry would be any word: East matches 
East. An exact formula match would be any number, date, or 
time: 2000 matches 2000. 


2. A nonselective match leaves the cell under a criterion field 
name blank and accepts any value for that field. This is 
handy when you are changing criteria — you don’t have to 
remove the field name but can leave it there for future use. 


3. A Selective formula used to match values can be a relational 
operator such as B2=2000, a logical function such as 
OR(B2,B2>1000), or any other suitable formula. In this case, 
B2 represents data in the input block beginning in cell B2. 
The field name is in B1. 
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Wildcard Matches — Wildcard characters are helpful when you 
are entering text as match criteria. 


? A question mark in one or more character positions means 
“accept any single character in this position.” J?ne matches 
Jane or June. Remember to use a double quote mark (") in 
front of any text that begins with a question mark. Otherwise 
SuperCalc will display an AnswerScreen when you type the ?. 


m An asterisk at the end of a text entry means “accept all 
characters that follow it.” Jo* matches Jones, Jorgensen, but 
not Jane. 


~ <A tilde means “accept anything except the letters following 
the tilde.” ~Jones matches anything but Jones, and ~J* 
matches all text entries except those starting with the letter J. 


AND and OR Matches — The way you enter selection criteria 
into the columns and rows of the criterion range indicates 
whether selection must meet all of the criteria (AND matches) or 
at least one of the criteria (OR matches). 


m To define selections that meet all of your criteria (for 
example, condition A AND condition B AND condition C), 
type as many selection criteria as you need all on one row in 
the criterion field of your spreadsheet. For example: 


COUNTY ZIP _ CODE 
Washtenaw 44044 


means “select all records with COUNTY = Washtenaw AND 
ZIP_CODE = 44044.” 
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m To define selections that meet at least one of your criteria, 


(condition A OR condition B OR condition C), type each 
selection criterion on separate rows in the criterion field of 
your spreadsheet. For example: 


COUNTY ZIP_ CODE 
Washtenaw 
44050 


means “select all records with EITHER COUNTY = 
Washtenaw OR ZIP_CODE = 44050.” 


Records with both conditions will be selected, but they only 
need to meet one condition for selection. 


You can use combinations of selection criteria on one row 
and multiple rows. When you enter two rows of criteria under 
a field name, SuperCalc accepts a record if either criteria is 
true. When you enter two columns of criteria, SuperCalc 
accepts a record only if both criteria are true. For example: 


COUNTY ZIP_CODE = 
Washtenaw 44044 
Jackson 44050 


means “select records with EITHER COUNTY = Washtenaw 
AND ZIP_CODE = 44044 OR COUNTY = Jackson AND 
ZIP_CODE = 44050. 


Cell References in Selection Formulas — You can use cell 
references in formulas to establish the selection criteria: 


Normally you want to test the current record during the 
search (that is, evaluate a record based on its own data). To 
do this, your formula must reference a cell in the second row 
of the input range (the row below the field name), even if it 
does not contain a record. The cell reference is automatically 
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adjusted as the search operation moves on to the next row. 
For example: 


ck Balancing 


Check 
Date Description Amount Deposit Balance 


12/186/1988Phone Company 
12/12/1988C leaners 
12/12/1388Department Store 
12/284 1988Pharmacy 

lv 5/1989Water 

1/ 5/1989Electric Company 
12/13/1988 

1/4 641389 


Beginning Balance 
Totals 

Net Activity 
Ending Balance 


> TIDATA1*B28 Form=D5>2B80 
Width: 12 Memory: 65 Last ColYRow:F28 
1> 
READY Fi:Help F3:Names Ctrl-Backspace'Undo Ctr1l—Break:Cancel 


This spreadsheet balances a checking account. To find all 
checks for over $200, define the input range as A4:D14. The 
criterion range is B19:B20. Cell B19 contains the name of the 
field you want to search, AMOUNT. The formula for B20 is 
displayed as the cell contents on the status line: D5>200. 
Cell D5, referenced in the formula, does not pass the test, so 
O displays as the value in cell B20. 


With the criterion formula, SuperCalc locates the check entry 
for $930.00 and the check for $250.00. The formula refers to 
D5 even though it is not the first record. If you had entered 
D6>200 as the formula, SuperCalc would have looked ahead 
one row and highlighted or extracted each check immediately 
preceding a check greater than $200. Whenever you have 
trouble getting the records you expect, check your cell 
references. 
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E You may want to use a forward cell reference in a criteria 
formula. Suppose you want to change the criteria in the 
checkbook balancing spreadsheet to look for missing checks. 
You change the criterion field name to NUMBER and enter 
this formula in cell B20: AND(A5<>0,A6-A5<>1). yy 


The AND indicates there are two parts to the formula. The 
first part is A5<>0. The second part is A6-A5<>1. The entire 
formula means, “If the value in A5 is not zero, then look 
forward to A6, subtract the value in A5 from it, and if the 
answer is not 1, then A5 passes the test.” Whenever the 
current row passes the test, it will be highlighted or extracted. 


m When you want to test each record based on an absolute 
value, you may refer to a cell outside the input range. For 
example, you can use an absolute cell reference to set a “flag” 
to take some action. Suppose you set a flag in a cell outside 
the input range, such as cell A2, to switch between 1 and 0. 
You could then enter a criterion formula such as: 


IF($A$2,E2=83,E2=84) 


If the value at A2 is 1, then any record with 83 in column E 
passes this test. If the value at A2 is 0, then any record with 
84 in column E passes this test. 


An absolute cell reference can come in handy if you want to 
include a formula that must be recalculated, such as a DATE 
function. If that function is included in the criterion formula 
— such as B5>DATEVALUE(" 9/15/88","MDY"), SuperCalc 
must recalculate it for each record in the input range. You 
can greatly improve the speed of the search by putting the 
function in a cell outside the criterion range, say C1, and 
referencing that cell in your formula: B5>$C$1. That way 
the function only needs to be calculated once. 
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Criterion Notes — When you specify text criteria, you must be 
precise. You must be careful, for example, about the use of 
blank spaces created with the spacebar as well as use of 
uppercase and lowercase: 


"SmithA" will not match "Smith A". 
"Smith" will not match "smith" or "SMITH". 
Whenever you request a Find, Extract, Select, or Delete operation 


and SuperCalc cannot find any records with data that match your 
criteria, this message displays: No matching record found. 


If you think a matching record should be found, check that both 
the input and criterion ranges are correct. Then double check the 
criteria you specified. 


//Data,Output 


Specifies the range of cells in which the requested data (from 
either Extract, Unique, or Select) will go. This range must allow 
enough rows for all the requested data or an error message will 
be displayed when the range becomes full. 


When you select //Data, Output, the currently defined range 
displays. 


If you define an output range that overlaps an input range, an 
error message displays. 


You can limit the number of records to be placed in the output 
range by limiting the size of the range. For example, if the output 
range is specified at a length of 5 rows (one row reserved for field 
names) and there are 20 matching records in the input range, only 
the first four of the matching records will be in the output range. 
After filling the range, SuperCalc will ignore any other matching 
records in the database and displays this message: Output area 


full. 
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The first row specified in the output range is reserved for field 
names. You must type field names in the first row of the output 
range when you want to control which fields will appear and 
their order. If you leave the first row blank, SuperCalc copies the 
fields of each record from the input range column by column 
(field by field) until the output range has been filled. If the 
output range is wide enough and the first row is blank, the entire 
record appears. 


The output range must be defined before you use Extract, 
Unique, or Select. 


For example, the input range may contain a phone list with these 
fields: 


LAST NAME FIRST NAME DEPT TITLE PHONE 


To prepare a quick phone reference list, the output range can be 
reordered and limited by entering these field names into the first 
row: 


PHONE FIRST NAME LAST NAME 


//Data,Find 


Searches the input range for data that matches the criteria you 
specified in the criterion range. For example, you might tell 
SuperCalc to search for all products with sales of more than 
$100,000. As it finds the matching data, SuperCalc highlights the 
record on your monitor. You may then either go on to the next 
record by pressing the Down Arrow key or scroll left and right 
to see other fields by pressing the Left Arrow and Right Arrow 
keys. 


You must specify input and criterion ranges before using Find. 
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//Data,Extract 


Copies the requested data from the input range to the output 
range, leaving the original records intact. SuperCalc copies only 
the displayed text or values (not the formulas) of the cells. If the 
output range already contains data, the program blanks it before 
the new data is copied to it. 


You must specify input, output, and criterion ranges before using 
Extract. 


//Data,Unique 


Works the same as Extract, but if more than one record matches 
the selection criteria in exactly the same way, only one of those 
records is copied to the output range. For example, suppose a 
spreadsheet has these records in the input range: 


FIRST NAME LAST NAME 
Jack Smith 
Mary Jones 
Sally Smith 
Joe Jones 


If you select Unique with this criterion range: 


LAST NAME 
Smith 
Jones 


only Jack Smith and Mary Jones, the first Smith and Jones in the 
input range, will be copied to the output range. If you used 
Extract instead of Unique, all of the records would be copied to 
the output range. 


//Data,Select 


A variant of Extract that lets you browse through the records that 
meet your criteria and select data to copy to the output range. As 
SuperCalc finds matching records, it highlights each record on the 
monitor and gives you the option of accepting or rejecting the 
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data in that record. As with Find, you may move among fields in 
the record with the Left Arrow and Right Arrow keys. 


SuperCalc copies only the displayed text or values (not the 
formulas) in the cells. 


You must specify input, output, and criterion ranges before using 
Select. 


//Data,Remain 


Lets you leave the spreadsheet cursor in its current position when 
you terminate the //Data command, and return to READY mode. 
This makes it easy to leave the cursor on a record you have 
requested in order to edit it. If you terminate //Data without 
Remain, the cursor returns to the cell it occupied when you 
entered the //Data command. 


Remain clears any existing title locks. 


//Data,Delete 


Removes the records in the current database which match the 
selection criteria. You will be prompted for each record which 
matches the criterion. 


When you select //Data, Delete, these options display: Yes, No, 
Remaining, Down Arrow, Up Arrow, Return to end: 


Yes deletes the record. No retains the record. Remaining deletes 
the rest of the matching records in the database, including the 
current one. Down Arrow moves to the next selected record 
and Up Arrow moves to the previous selected record for 
inspection. Return cancels the Delete command. 


Delete will not loop around from the bottom of the database to 
the top. If you skip some records then delete the remainder, the 


skipped records are still present. 


You must specify input and criterion ranges before using Delete. 
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Data Management Considerations 


Automatic Range Adjustment 


Since /Insert and /Delete automatically adjust the input, output, 
and criterion range definitions, you may add or delete records or 
fields in the middle of these ranges without needing to redefine 
them. 


Using /Arrange 


The //Data data management options identify records that meet 
the criteria you specify by field, and distinguish these records 
from the rest of the input block. /Arrange,Block can sort the 
entire input range in alphabetical or numerical order by up to 
three fields. For example, you can arrange the records first by 
state, and then by counties and zip codes within counties. 


You can use //Data and /Arrange, Block together by first extracting 
records that meet the criteria and then arranging them in a new 
order. 


Increasing Spreadsheet Size 


If your database is larger than will fit in the available rows, see 
/Global, Optimum, Next, earlier in this chapter, for information on 
how to increase your spreadsheet size. 


Splitting a Database 


If you want to maintain more records than will fit in a spreadsheet 
given your current memory capacity, you can use /Save to split 
the database into separate spreadsheets. For example, you could 
put customers A-K in one and customers L-Z in another. 


Data Analysis 


The data analysis commands include these //Data options: 
Analysis, Block, Matrix, Parse, and Table. They perform these 
data analysis operations: 
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m Analysis, Distribution calculates frequency distributions; 
counts cells with values falling within specified intervals. 


@ Analysis, Regression performs multiple regression analysis with 
up to 16 independent variables; uses linear, quadratic, or 
cubic regression lines for one independent variable. 


= Matrix multiplies and inverts matrixes; solves simultaneous 
equations with up to 89 variables. 


m Parse breaks a series of data strings into fields according to 
user-defined field descriptions. 


m Table displays results for each value with one- and two- 
variable test formulas. 


//Data,Analysis 


This command lets you perform regression analysis or frequency 
distribution analysis of data in a range. Its options are 
Distribution and Regression. 


//Data,Analysis, Distribution 


Lets you analyze the distribution of data in a range. A frequency 
distribution tells you how many values in the range fall within the 
intervals you specify. 


Distribution requires two ranges: 


m The input range contains the values to be analyzed. They 
will be grouped into value intervals. The frequency of values 
within each interval will be output. 


m The bin range contains the bin/sort values to test against — 
the value intervals. After the command is executed, the next 
column will contain the frequency of values occurring within a 
each interval. 
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The bin/sort values must be in ascending order with the 
smallest number at the top of the column. There can be 
unequal steps between the intervals. 


When you select //Data, Analysis, Distribution, you are prompted 
for the input range and the bin range. Include all values being 
counted in the input range; include all interval values in the bin 
range. 


For example, notice the results of this command: 


//Data,Analysis,Distribution,B2:C4,E3:E6 


Values to Analyze 
9 98 Sort Values Results 
37 15 5 
16 19 


65 Last Col/Row:F? 


READY F1:Help F3:Nanes Ctrl-Backspace:Undo Ctrl—Break:Cancel 


The results in column F show that there are 0 values in the input 
range less than or equal to 5, 1 value greater than 5 but less than 
or equal to 12, 3 values greater than 12 but less than or equal to 
20, O values greater than 20 but less than or equal to 25, and 2 
values greater than 25. 
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//Data,Analysis,Regression 


Performs a regression analysis on data. The results are entered in 
the spreadsheet in the range you specify. Regression identifies the 
degree to which a set of independent variable ranges (X-values) 
are related to a dependent variable range (Y-values). You can 
have up to 87 independent variables. 


For analyses with one independent variable, you can request that 
the analysis be linear, quadratic, or cubic. SuperCalc performs 
linear analyses when a data set has more than one independent 
variable. Analyses are based on these equations: 


Linear Y = A1X1 +... + AkXk +C 
Quadratic Y = AyX + A2X2 + C 
Cubic Y = AyX + A2X2 + A3X3+C 


You can set the Y-axis intercept to zero, or have SuperCalc 
calculate it. 


When you select //Data, Analysis, Regression, these options display: 
Go, X-Range, Y-Range, Output, Fit, Intercept, Zap, and Quit. 


//Data,Analysis,Regression,Go 


Executes the regression analysis. You must specify the X-range, 
Y-range, and output range before using Go. The default Fit and 
Intercept option selections are Linearand Calculate, respectively. 
If you want to change these, you must do so before selecting Go. 


//Data,Analysis,Regression,X-Range 


The range containing all columns of independent variables. 
There can be up to 87 independent variables, in adjacent 
columns. If Intercept is set to Zero, you must have at least one 
more value in each variable set than the number of independent 
variables. If Intercept is set to Calculate, you must have at least 
two more values than independent variables. 
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//Data,Analysis,Regression, Y-Range 


The partial-column range containing values of the dependent 
variable. The X-Range and Y-Range settings must have the same 
number of rows. 


//Data,Analysis,Regression,Output 


The range that will contain the calculated output. It can be 
specified as either the upper-left cell of the range or the entire 
range. The actual output may exceed the output range if the 
output is larger than the range specified. See Regression Results, 
later in this chapter, for a discussion of the contents of the output 
range. 


//Data,Analysis,Regression,Fit 


Generates the coefficients to a Linear, Quadratic, or Cubic 
equation for a single independent variable. For regressions with 
more than one independent variable, the fit will be computed as 
linear. 


//Data,Analysis,Regression, Intercept 


Tells SuperCalc how to obtain the Y-axis intercept. 


Calculate The default; indicates that the Y-intercept is to 
be calculated as the estimated Y-value for 
X=0. 

Zero Indicates that the Y-intercept will 


automatically assume the value of zero. 


//Data,Analysis,Regression,Zap 


SuperCalc remembers the last X-range, Y-range, and output range 
entered, so you can change only those variables you need to 
obtain further test results. Zap clears all remembered Regression 
ranges; clear individual ranges by pressing a hyphen (-). 
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//Data,Analysis,Regression, Quit 
Returns to READY mode. 


Regression Example a 


The following example uses the default for Fit (Linear), Intercept 
is calculated (Calculate). The X-range is A1:A11, the Y-range is 
B1:B11, and the upper-left corner of the output range is D1. The 
command sequence is: 


//Data,Analysis,Regression,Intercept,Calculate, 
X-Range,A1:A11,Y-Range,B1:B11,0utput,D1,Go 


Following computation, the spreadsheet looks like this: 


yr P 
Constant 135.8785 
Std Err of Y Est 250.9571 
R Squared(Ad,j, Raw) .6437983 .6794185 
No. of Observations 11 
Degrees of Freedom 9 


Coeff icient(s) 111.8589 
Std Err of Coef. 25.42735 


Regression Results 


When SuperCalc performs regression analysis with Fit set to 
Linear, it solves for this equation: 


Y = A1X1 +... + AkXk+C 
where A1 is the regression coefficient of the first independent 


variable, X1, and Cis the Y-intercept, the point where the 
regression line crosses the Y-axis. 
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To express the equation in words, 


Dependent variable = Constant + (first independent variable * first 
coefficient) + (second independent variable * second coefficient), and 
so on for additional independent variables 


The equation is solved for values that are as close to the values of 
Y as possible in a least squares line. SuperCalc can also perform 
regression analysis based on second order (Quadratic) and third 
order (Cubic) regression curves. 


= Constant is the Y-axis intercept of the regression line. It is 
zero if you specified Intercept, Zero. Otherwise, it is C in the 
regression equation. 


mW Std Err of Y Est is the standard error of the estimated 
Y values. 


æ R Squared is a statistic ranging from 0 to 1 that indicates how 
much of the change in the dependent variable results from 
changing the independent variable. The closer to 1, the 
closer and more predictable the relationship between the 
variables. 


E No. of Observations is the total number of values included 
for the dependent variable. 


m Degrees of Freedom is the number of observations less the 
number of independent variables for Intercept set to Zero; 
observations minus independent variables minus 1 for 
Intercept set to Calculate. 


Æ Coefficients are the values 41,...,Ak in the previous formula; 
with a single independent variable the coefficient represents 
the slope of the regression line. There is one coefficient for 
each independent variable, read from left to right in the same 
order as the X-Range variables were defined. 


@ Std Err of Coef. gives an error estimate of the coefficients, 


one for each independent variable. In the output range, each 
displays below the corresponding coefficient. 
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Regression analysis is not updated automatically. If you change a 
value in the X- or Y-range, you must execute the command again 
to see the new results. 


Once you have regression coefficients for independent-dependent 
variable pairs, you can use those coefficients to predict the 
dependent variable value from a specified independent variable 
value. See Chapter 11 of the User’s Guide for instructions. 


//Data,Block 


Generates a range of ascending or descending numbers or 
time/date values. You will first be prompted to enter the range 
where you want SuperCalc to place the generated values. After 
you enter the range, these options display: Number, Growth, 
Date, and Order. 


First specify the order in which you want SuperCalc to fill the 

range, across by row, or down by column. Column is the default. 

If the Block range is A3:D6, for example, and you select Column 

order, the first two cells filled are A3, A4; with Row order, A3, B3. 

Next, select the type of value you wish to generate. 

Number, Growth, and Date all require that you specify: 

m Start value — the first value to enter in the range. 

m Step value — the increment by which you wish to increase 
each created value. The step value may be positive or 
negative. 


m Stop value — the final value you want to generate. 


SuperCalc will stop generating values when it encounters 
either the end of the range or the stop value. 


The defaults are 0, 1, and 999999999999999 for Number, and 1, 
.1, and 999999999999999 for Growth. 
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Date prompts for Day, Week, or Month. The step value is in units 
of the selected period. The default start value is TODAY. The 
default step value is 1 (day, week, or month). The default stop 
value is DATE(2,28,2100). 


Return after typing each value. 


//Data,Block, Number 


Fills the specified range with numbers in a linear relationship: 
new value = previous value + step 
Number can be used to fill a range with item numbers or times. 


Or it can generate a range of intervals (sort bins) for 
//Data, Analysis, Distribution. 


//Data,Block,Growth 

Fills the specified range with numbers in a geometric relationship: 
new value = previous value(1 + step) 

Each new value is equal to the previous value multiplied by 


1 + step. For example, with step = .1, the values grow by 10%. 
Step can be positive or negative. 


//Data,Block,Date 
Similar to Number and Growth, except that the step value can be 
for either Day, Week or Month. Use Date functions to specify the 
start and ending values. The default start value is TODAY. 

For example: 

1. Select //Data,Block, and specify the range B2:H3. 

2. Select Order,Row,Date, and specify Month. 

3. Enter the start, step, and stop: 

DATE(7,1,88) Return 1 Return DATE(7,1,89) Return. 
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The filled range looks like this: 


7/ 1/88 87 1/88 97 1/88 187 1/88 11 1/88 127 1/88 14 1489 


27 1/89 3/ 1/89 47 1/89 5” 1/89 6r 1/89 77 1/89 


The start date, DATE(7,1,88), is placed in cell B2. The increment 
of one month generates the next date, 8/ 1/88. The order, Row, 
places that date in C2. The dates continue to generate across the 
range until the stop value, DATE(7,1,89), is encountered at G3. 


//Data,Block,Order 


Specifies whether the range will be filled downward by column or 
across by row from the upper-left corner of the range to be filled. 
The default is Column. 


//Data,Matrix 


Performs a variety of matrix operations: inversion, multiplication, 
and solution (of simultaneous equations). The maximum size of a 
matrix array is 90 rows by 90 columns. Simultaneous equations 
can have up to 90 variables. When you select //Data,Matrix, 
these options display: Multiply, Invert, Solve. 


//Data,Matrix,Multiply 


Performs matrix multiplication. You must specify three ranges: 
the first range to multiply (Rangel), the second range to multiply 
(Range2), and the output range where the product is written. 
There must be the same number of columns in Rangel as there 
are rows in Range2. The maximum size of a matrix array is 90 
rows by 90 columns. 
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This example shows how multiplying two matrixes with 
construction information can determine the quantity of materials 
needed. The first matrix indicates the number of each type of 
house to be constructed during each phase of the project. The 
second matrix indicates the quantity of roofing material needed 
for each house type: 


Paper Shing les 


By multiplying the two matrixes, you can determine the amount 
of materials needed for the tract: 


2. Select //Data,Matrix,Multiply. 

FA Enter Rangel as B3:D4. 

+ Enter Range2 as B7:D9. 

4, Enter the upper-left cell of the output range: B12. 


SuperCalc multiplies the matrixes for you and enters the results in 
the range specified in the form of another matrix: 


Paper Shingles Tiles 
196 239 a 


379 238 
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The product of two matrixes can be found only if the number of 
columns of one is the same as the number of rows of the second. 
The final product will have as many rows as the first and as many 
‘columns as the second. 


//Data,Matrix,Invert 


Inverts a matrix, if it is invertible. Two ranges are required: the 
input range (Rangel), and the output range (Range2). Range2 
must be the same size or larger than Rangel. In order to be 
invertible, the matrix must be square (the same number of rows 
as columns) and its determinant must not be zero. The maximum 
size is 90 by 90. 


To invert the matrix: 


Soybeans Cottonseed 


1. Select //Data,Matrix,Invert. 
2. Enter Rangel: B3:D5. 
3. Enter Range2, the upper-left cell of the output range: G3. 


SuperCalc inverts the matrix enters the results in the range 
specified: 


-2.85714 4,44e-16 5.714286 


3.571429 -2:5 13571429 
1.428571 5 -7,85714 
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//Data,Matrix,Solve 


Solves a set of n equations with n unknowns. Two ranges are 
required. Rangel is an (m+1) x n array of the variable coefficients 
and equivalent values for the equations, the input range. Range2 
is a column array which contains the solutions to the equations, 
the output range. SuperCalc can solve a matrix containing up to 
90 equations and 90 variables. 


In order for a set of equations to have a solution, the determinant 
of the variable coefficients must be non-zero. 


For example, given the set of equations: 
Ai + Sy = 7 
x+y=3 


Rangel is B2:D3; Range2 is F2:F3. The command sequence is: 
//Data,Matrix,Solve,B2:D3,F2:F3 


The spreadsheet, following solution, looks like this: 


Solutions 
2 


1 


The x variable coefficients are in column B; the y variable 
coefficients in column C; and the equation constants are in 
column D. 


The equation solutions are in column F: x=2, y = 1. 


//Data,Parse 


“Breaks” a set of fields out from lines of text . Data is parsed 
according to the rules specified by a format line. 
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When you select //Data, Parse, these options display: Go, Create, 
Edit, Input, Output, Zap, Quit. 


The first step in parsing is to create a format line, either by 
entering appropriate symbols or by using //Data, Parse, Create and 
specifying the upper-left cell of the range to be parsed. You can 
create multiple format lines in the input range. For example, you 
would probably have a different format line for column headings 
and the data beneath them. Format lines control parsing of all 
data beneath them in the input range until another format line is 
encountered. 


Then you edit the format line, if necessary, specify an input range 
containing the format line(s) and all data to be parsed, and 
specify an output range where parsed data will be written. Select 
Go when all settings are correct. 


//Data,Parse,Go 


Executes the Parse command. 


//Data,Parse,Create 


Inserts a row above the specified cell and places a “best-guess” 
format line in the new row. The format line should be in the cell 
directly above the first row to be parsed. 


//Data, Parse, Create inserts a vertical bar (|) at the beginning of 
the format line. You can also type a format line directly into a 
cell by placing this character at the beginning of the line. If 
format lines are contained in a cell in the first column of an 
output range, they will not be printed on the report unless 
preceded by a double quote ("). 


You will need to create a format line for each different 
arrangement of data to be parsed. 


The following symbols can be used in format lines. 


First character of a text field. 


V First character of a value field. 
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D First character of a date field. 
T First character of a time field. 


S Skip the character below during parsing (entered manually as 
an edit). 


> Continuation character of current field type. 


* Don’t care character; if character below is blank, ignore. 
Otherwise, treat as part of current field definition. 


For example: 


|">>>** indicates, “The first four characters are text. The next 
two characters can be text or blank.” These symbols are 
appropriate for: 


Stock, Bull, and SALES 


but not: 
All, 1400, and Auction. 


|V>>>* indicates, “The first four characters are numbers. The 
next character can be a number or blank.” These symbols are 
appropriate for: 


63.45, 45000, and 1988 


but not: 


3.4, .45, and 145000. 


Rules for Format Lines 


Æ The length of a data field cannot be less than 1 (the first 
character symbol) plus the number of continuation (>) 
characters. 


m The length of a data field cannot be greater than 1 (first 
character symbol), plus the number of (>) and (*) characters. 
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Æ The data field must be the same type as the format line’s first 
character symbol. V is not appropriate for a date, " is not 
appropriate for a value, and D is not appropriate for text. 


The format-line: 


| "S>>**"S>>>****V>>>* 


will accurately parse: 
Sales Quotes 4500 
Stock Purchase 63.45 
BULL MARKET 1988 


//Data,Parse,Edit 


Lets you edit the format line in the specified cell. 


//Data,Parse,Input 


Defines the range of data to be parsed. The range can be a 
column or a partial column. 


The first line of the input range should be a format line, although 
there may be other format lines elsewhere in the range. 


//Data,Parse,Output 


Prompts you to enter the range where the parsed data will be 
output. Parsed data will be written into this range after the 
individual field columns have been broken out. 


//Data,Parse,Zap 


Clears the input and output ranges. 
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//Data,Parse,Quit 


Returns you to READY mode. 


//Data,Table 


Lets you test different values in formulas and review the results of 
each evaluation. With this command, you can perform “what-if” 
analysis and prepare data for charts. You can evaluate one- and 
two-variable formulas. 


//Data,Table,1 


Lets you see what happens each time one-value is varied in a 
formula. You enter a row of one or more single-variable test 
formulas and a column of values to be entered into the test 
formulas. Then you specify a table range — extending down to 
the last value and across to the last formula, and an input cell to 
hold each value in turn during evaluation. 


//Data, Table, 1 reads each variable value into the input cell, 
evaluates the formulas, and writes a row of formula results, one 
for each formula, next to each value. 


For example, you can enter the values in column B in the 
following spreadsheet. Enter the formula 2*B1 into C2, and 
the formula (2*B1)*B1 into D2. 


Select //Data,Table,1 and specify the range B2:D9, and the 
input cell B1. The values in the range C3:D9 are generated 
by the Table command, shown here in Formula mode: 


(2%B1)*B1 
2 
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Each value in column B is entered into the input cell, B1. Then, 
the value in B1 is entered into the formula in C2 and the formula 
in D2, and the result of each formula is written in the column 
“below that formula next to the value that yielded it. 


//Data,Table,2 


Shows the effects of varying two variables in a single formula. 
//Data, Table,2 evaluates only one formula with two variables. 


You enter the formula into the upper-left corner of the table 
range, with values for the first variable in the column below the 
formula. Enter values for the second variable to the right of the 
formula, at the top of each table column. Input cell 1 holds each 
value of the first variable as calculations are made; input cell 2 
holds each value of the second variable. 


For example, you can enter the values in column B and 
across row three in the following spreadsheet. Enter the 
formula A1*B1 into B3. 


Select //Data,Table,2, and specify the range B3:H9 and the 
input cells A1 and B1. The values in the range C4:H9 are 
generated by the Table command, shown here in Formula 
mode: 


Input 1 “Input 2 
A1xB1 


3 
3 
6 
9 
12 
15 
18 
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When you enter the //Data, Table,2 command sequence, each 
value in range B4:B9 is entered into cell Al. At the same time, 
each value in range C3:H3 is entered into cell B1. Al is 
multiplied by B1, according to the formula in cell B3, and the 
result is written at the intersection of each column and row value 
pair. 


//Data,Table,Zap 


Clears the current range and input cell specifications. 


Special Considerations 
Tables are not recalculated when the spreadsheet is recalculated. 
To recalculate a table, use the TABLE key, Alt-F9. 


Only one table at a time can be active. The active table is the 
one whose ranges have most recently been defined. 


Input cell references can be used more than once in a formula. 


Using Databases with Data Tables 


Data Tables are especially useful with databases. You can 
perform “what-if” projections and evaluations while keeping the 
database data itself intact. Projections and analysis are performed 
based on the data without actually overwriting data. 


A One-value Data Table 


A one-value data table can show “what-if” projections based on 
changes to a single variable in your database. 
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For example, the following database contains population 
estimates for cities based on a population increase of 3% per year. 


Population increase per year: 


To see how a different figure for the increase would affect the 
year 2015, you could enter different values into the Population 
Increase cell A9, noting the change to the figures. But with this 
method, you've altered the database and have no record of each 
separate projection. 


A data table can show you the results for each value you want to 
test without altering the database data. 


To créate the data table, enter the population increase values in a 
column (see B13:B18 below). Then enter the formulas for the data 
table (cells C12, D12, E12, and F12). The formula in C12 is 
B3*((1+$A$9)A30)) (30 years of population increase from the 
1985 figure), D12 is B4*((1+$A$9)A30), and so on. 


Select //Data,Table,1, specify the range B12:F18, and the input 
cell A9. 
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The values are generated as shown here: 


pulation increase per year: 


Santa Rita Peterstown Banner City Boonville 
B B B 


28,788 18,158 33,288 9,638 
38,791 24,463 44,749 12,988 
52,131 32,876 68,137 17,443 
69,857 44,055 88,585 23,375 
93,345 58,868 187,681 31,234 
124,386 78 5443 143,488 41,628 


+ Il y 
Width: 15 Memory: 64 Last ColYRow:G18 
1> 
READY F1:Help F3:Names Ctrl-Backspace‘Undo Ctrl-Break:Cancel 


You can now see each city's projected population figure in the 
year 2015 for increase rates from 0% to 5%, and your database is 
still intact. 


Using Data Tables with Database Statistical Functions 


Using database statistical functions with data tables offers another 
way to perform database analysis. 


SALESPERSON ITEM INU AMOUNT 

System 358 56 

1116234 Wong System 425,58 
1115437 Maitlen Part 57 BB 
1115277 Maitlen Service 172,34 
1116332 Andrews Part 98.58 


1115443 Wong System 124.98 
1115546 Maitlen Service 47.76 
1115548 Andrews Part 12,58 
1116221 Andrews System 313,78 
1116883 Wong Part 37.88 
1115342 Wong Service 132.70 
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This database shows sales invoice information including the name 
of the salesperson who completed the sale, the item that was 
sold, and the invoice amount. 


With this database and the database statistical functions, you can ba 
create a data table that helps you to analyze and compare each 
salesperson's performance. With a one-value data table, you can 
see the number of invoices that each salesperson generated and 
the average sales dollar for each salesperson. With a two-value 
data table, you can see how many of each item that each 
salesperson sold. 


To create the one-value data table, enter the salespersons’ names 
in a column (see G3:G5 below). For the database statistical 
functions, create a criteria range in A18:A19 by entering the field 
name SALESPERSON in A18. The blank cell in A19 will serve as 
the input cell. Next, enter the formulas 
DCOUNT(A1:D12,3,A18:A19) in cell H2, and 
DAVG(A1:D12,3,A18:A19) in cell 12, where A1:D12 contains the 
database for input, 3 is the offset field to count or average, and 
A18:A19 contains the criteria. 


Select //Data,Table,1, specify the range G2:15, and the input cell 
A19. 
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The values are generated as shown here: 


Naitlen 161.21 
1116234 Wong 4 156.92 
1115437 Maitlen 188.23 
1115277 Maitlen Service 141.57 
1116332 Andrews Part 
1115443 Wong System 
1115546 Maitlen Service 
1115548 Andrews Part 
1116221 Andrews System 
1116883 Wong Part 
1115342 Wong Service 


To create the two-value data table, enter the salespersons’ names 
down a column (see G3:G5 below) and enter the items (System, 
Part, Service) across in a row (H2:J2). For the database function, 
create a criteria range in A18:B19 by entering the field name 
SALESPERSON in A18 and ITEM in B18. The blank cells in A19 
and B19 will serve as the input cells. Next, enter the formula 
DCOUNT(A1:D12,3,A18:B19) in cell G2, where A1:D12 contains 
the database for input, 3 is the offset field to count, and A18:B19 
contains the criteria. 


Select //Data,Table,2, specify the range G2:J5, and the input cells 
A19 and B19. 


The values are generated as shown here in Formula mode: 


Part Service 


1 1 
z 
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//Export 


-//Export saves spreadsheets in a data format that can be used by 

programs other than SuperCalc. The extent of data conversion — 
depends primarily upon the similarity between features and data 

format in SuperCalc and the foreign program. Export formats 

include XDIF, DIF, Comma Separated Values, and dBase III. 


Use /Save to create files that can be loaded by previous versions 
of SuperCalc, and Lotus 1-2-3. See /Save, earlier in this chapter, 
for more information. 


//Export, - XDIF filename Backup All 
; - change | - Values 
Overwrite Part, 3 All, from range 
Values, from range 
DIF, filename | Backup Colwise 7 i All 
i Change Rowwise Part, from range 
Overwrite 
CSV, filename Backup ay 
E Change Lara from range 
Overwrite Pd 
dBase, filename , — Backup ra 
- Change i Part, from range 
Overwrite 


When you select //Export, first select the file format to which you 
want to export the data, then specify a filename. If the filename 
already exists, your prompted to Backup, Change, or Overwrite 
the original file. 


Once you've specified the filename, additional options let you 


define which data in the SuperCalc file you want to export, and 
whether to export contents or values of that data. 
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//Export,XDIF 


Converts the spreadsheet to the extended DIF format. The 
extension .sdi is supplied automatically. 


XDIF is a superset of the DIF standard. XDIF can contain 
SuperCalc formulas and display formats. Some programs can 
interpret data in XDIF files. Some will ignore the formula and 
display format directives and read only the values. 


All Converts the entire spreadsheet into XDIF 
format. 
Values Converts the entire spreadsheet into XDIF 


format. Exports cells with formulas as the 
calculated value, not the formula. 


Part Lets you select which part of the spreadsheet 
to export. Once you’ve entered the range, 
you can specify All or Values: 


g All Converts formulas as 
formulas. 
e Values Converts cell values only; 


not formulas. 


//Export,DIF 


Converts the spreadsheet to the DIF file format. DIF is the 
standard Data Interchange Format as defined by the Software Arts 
Inc. publication SATN-18, Programmers Guide to DIF. The 
extension .difis supplied automatically. 


DIF can contain only values from a spreadsheet, not formulas and 


display formats. Many programs can read data files that conform 
to the DIF standards. 
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You must specify Colwise or Rowwise export: 
Colwise Each column becomes a record. 
Rowwise Each row becomes a record. 


Then, specify whether to export All or Part: 


All Converts the entire spreadsheet. 

Part Lets you select which part of the spreadsheet 
to export. 

//Export,CSV 


Converts the spreadsheet to the Comma Separated Values format. 
The extension .csv is supplied automatically. 


Each row becomes one line (record), and each cell within that 
row is separated with a comma. 


You can specify whether to export All or Part: 


All Converts the entire spreadsheet. 
Part Lets you select which part of the spreadsheet 
to export. 


m Text is enclosed in double quotes. Double quotes within 
SuperCalc text become double-double quotes in the CSV file. 
For example, sample becomes "sample", and "quote" 
becomes """quote""". 


WN Repeating text is enclosed in double quotes: °= becomes "=", 


NW Textual values are treated as text: ("textual") becomes 
"textual". 


E Comma Separated Value format does not contain formulas or 
display formats. Only formula values are converted. 
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aan 


//Export,dBase 


Converts spreadsheets into dBase III database files. Each column 
is converted to a field; each row is converted to a record. The file 
extension is .dbf. The first row becomes field names; the rest of 
the rows are records. 


Field sizes are determined by the column widths. Setting a 
column to 127, SuperCalc’s maximum, causes the dBase field to 
be of maximum size. 


You can specify whether to export All or Part: 


All Converts the entire spreadsheet. 
Part Lets you select which part of the spreadsheet 
to export. 
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//File 


Specifies the default data directory for the File List, displays the 
File List, and specifies new directory paths for automatic file 
searching. 


You can display a list of files on the default directory with 
//File,List, or by pressing F3 in FILE mode. The list also displays 
automatically when you request a file that cannot be found for 
loading or importing. You can change the default data directory 
while viewing the File List (see Chapter 1), or you can use 
//File, Directory to change the default directory. 


File, — Directory,default directory name 
List, SuperCalc 


1-2-3 

Print 

Macro 

Config 

All 

Path, — Global, Edit ,drive/directory search paths 
- Clear 

Zap 

Spreadsheet, C Edit,drive/directory search paths > 
Zap 

//File,Directory 


Specifies the default data directory for the File List. Enter the new 
drive/directory path. 


For example, if you select //File, Directory,B:\STATEMENTS, the 
next time the File List displays, it will contain files from drive B in 
the directory STATEMENTS. 


Specifying a default directory with //File,Directory is equivalent to 
displaying the File List, entering a path, then pressing F4 to 
update the default data directory. 


Use /Global, Keep to retain the directory as the default for future be 
SuperCalc sessions. 
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//File,List 


Displays the File List for the default directory. You may limit the 
display to files with a specific extension, or list all files in the 
appropriate directory. Choose from the following options: 


Option Files Displayed 

SuperCalc * cal 

1-2-3 * wk? (Lotus 1-2-3 .wks 
and .wk1 files) 

Print * prn 

Macro *.xqt 

Config * cfg 

All bt 

//File,Path 


If you enter an incomplete filename (not qualified with a 
drive/directory) when SuperCalc is performing a load or import 
operation, the program will search for the appropriate data file. 
//File, Path lets you define datapaths for SuperCalc to use when it 
searches for files. 


The datapaths are directory lists, similar to those set through the 

DOS command PATH=. They consist of lists of drives and 

directories where data files might be located. The entries are 

separated by semicolons (5). 

When locating a file, Supercalc searches directories in this order: 

1. The default directory set at the File List or by //File, Directory. 

2. The Spreadsheet datapath directories. 

3. The Global datapath directories. 

4. The path set using SET DATAPATH= directly through DOS or 
in the system's AUTOEXEC.bat. This is optional. SuperCalc 
only looks here if you have set this up independently of the 


//File, Path command in SuperCalc and there is no Global 
datapath defined. 
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‘peau AAA ASE AA AA A 


If after searching the above directories, the file still cannot be 
found, the File List displays. 


In addition to setting up to two datapaths using the Spreadsheet 
and Global options, you can restrict the search down a datapath 
by inserting a vertical bar (use the | key) in the datapath. The 
vertical bar tells SuperCalc to stop the search at that point in the 
datapath. 


For example, with the path set by 

//File, Path, Spreadsheet, Edit,C:\ DATA; |, SuperCalc does not 
continue the search to the global datapath nor to the DOS SET 
DATAPATH= because of the vertical bar in the spreadsheet search 
path. 


//File,Path,Global 

Lets you define a datapath for the whole SuperCalc session. 
For example, if several users are storing files on the same hard 
disk, each might have a different set of data directories. Then, 
each user could have a separate global datapath to restrict file 


searches to personal directories. The global path would apply to 
the entire SuperCalc session for the individual user. 


You may save the global path in your configuration file for future 
SuperCalc sessions with /Global, Keep. 


//File, Path, Global, Edit 


Lets you enter or edit a global datapath. 


//File, Path, Global, Clear 


Removes the existing global datapath for the current SuperCalc 
session. After clearing the global datapath, use /Global, Keep if you 
wish to remove the global datapath from your configuration file. 


//File, Path, Global, Zap 


Resets the global datapath to the last global datapath saved with 
/Global, Keep. 
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//File,Path,Spreadsheet 


Lets you define a datapath for the current spreadsheet. This 
datapath is saved with the spreadsheet. 


If files fall into logical groupings — say, sales data and budgets — 
then each type of file could be stored in a separate data directory. 
For example, if you have a directory nanied BUDGET, and in the 
directory are 12 spreadsheets named JAN.cal, FEB.cal, etc., you 
can use //File, Path, Spreadsheet, Edit,C:\ BUDGET to set up the path 
so that when you enter /Load,filename, SuperCalc looks in the 
BUDGET directory (after first looking in the default directory, if it 
happens to be something other than BUDGET). 


//File, Path, Spreadsheet, Edit 


Lets you enter or edit a spreadsheet datapath. 


//File,Path, Spreadsheet, Zap 


Deletes the spreadsheet datapath. File searches continue to use 
the global path, if one has been set, or the path defined using SET 
DATAPATH= through DOS. 


Examples 
With the following paths set: 
//File, Path, Global, Edit, C:\ SALES; CNACCOUNT 
//File, Path, Spreadsheet, Edit, B:\SALES 
SuperCalc will search for files in the following order: 
The default directory set at the File List or by //File, Directory. 
The spreadsheet datapath, B:\SALES 


The global datapaths, C:\SALES, and C:\ACCOUNT. 
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//Graphics 


//Graphics lets you see your spreadsheet data in graphic form, or 
lets you create textual charts for presentations. SuperCalc has 
defaults for the Graphics options, so to quickly see a graphic 
representation of your data, you need only specify a data series 
range. 


If //Grapbics is Disabled 


In some cases, SuperCalc may disable //Graphics 
to save memory for your environment. If this is 
the case on your system, you'll see a message 
when you first try to select //Graphics. Press F1 
when you see the message, and an AnswerScreen 
will show you how to enable Graphics. 


SuperCalc makes it easy to produce a wide variety of charts. You 
can quickly produce simple charts using only a few options, or 
you can produce customized charts by modifying the chart 
options. You can add titles and labels using various fonts and 
appearance options, determine the chart appearance, the colors of 
each component, line styles, etc. 


You can save with each spreadsheet as many charts as the 
machine’s memory will allow. Through the Load command, you 
can also include charts saved with other SuperCalc spreadsheets 
into the current spreadsheet. You can specify up to 16 different 
typefaces (fonts) for titles and labels to make your chart 
presentation quality, or select Auto to use SuperCalc’s default 
fonts. See Appendix F for a list of available fonts. 


The chart components are: 
Top Title The first title, which is usually the largest title, 


and at the top of your chart. The top title can 
be up to three lines. 
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Subtitle The second title, which is usually smaller than 
the top title, and is directly below the top title. 
The subtitle can be up to two lines. 


Footnote The last title below the chart, which is in the 
smallest size text, and is left-justified at the 
bottom of the page. The footnote can be up 
to three lines. 


X-Axis Title Heading below the X-axis labels that defines 
the X-axis. 
Y1-Axis Title Heading along the left side or top of the chart 


that defines the left Y-axis. 


Y2-Axis Title Heading along the right side or top of the 
chart that defines the right Y-axis. 


Legend Title Heading centered at the top of the legend that 
defines the legend labels. 


X-Axis Numbers or text that define the X-axis major 

Labels tick marks of an axis chart. Labels along the 
X-axis commonly represent time 
measurements such as months or quarters. 


Y1-Axis Numbers or text that define the Y1-axis major 
Labels tick marks of an axis chart. 

Y2-Axis Numbers or text that define the Y1-axis major 
Labels tick marks of an axis chart. 

Legend Numbers or text that identify the series in a 
Labels chart through matching colors and/or 


patterns. There is one label for each series. 


Data Labels Numbers or text that identify the value of 
each series. Data labels are placed next to 
segments for Pie charts, above data bars for 
Bar charts, or on points in a chart for charts 
such as Line, Area, X-Y charts, etc. 
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Ticks Small lines (major and minor ticks) on axis 
charts that indicate scaling units on the Y-axis 
and points (for example, time periods) along 
the X-axis for X-Y charts. Major ticks are 
labeled and mark the main scaling values on 
the axis, and minor ticks mark the incremental 
values between major ticks. 


) 


Grids Horizontal and/or vertical lines that project 
from the X-axis and Y-axis ticks, and are 
displayed behind an axis chart. 


Series A user-defined range of data (either partial 
row or partial column) to be displayed 
graphically. 


Basic Operations 


When you select //Graphics the //Graphics menu displays these 
options: View, Type, Data, Labels, Axis, Options, Global, Name, 
Plot, Zap, Quit. 


You build the chart using the commands: Type, Data, Labels, 
Axis, and Options. Type, Data, Labels, and Axis represent the 
main chart components. Options lets you select variations of the 
main chart types and change the attributes. Each of these 
commands, except Type displays a menu where you fill-in the 
information. These commands can be selected in any order. 


Each component has predefined attributes (global defaults). 
Changing the attributes only affects the current chart. When you 
bring in a new chart, the original global attributes are restored. 


You can, however, change the global defaults by changing the 
options on the menus and using /Global, Keep from the main 
SuperCalc menu. This saves the options in the default 
configuration file. You can use /Global, Keep, To to save the 
current options as defaults to a different configuration file. 


If you have more than one configuration file, you can use 
/Global, Keep, From, Graphics to load some or all of the graphics 
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options from a configuration file on disk, to overwrite the 
graphics options in the current configuration file. You're given a 
choice of loading: 


All Overwrites all the graphics options in the 
current configuration file. 


Colors Overwrites all color options. These include: 
all colors for chart box, axis box, legend box, 
axes, ticks and grids, series, word text, labels, 


and titles. 

Globals Overwrites all settings defined with 
//Graphics, Global. 

Text Overwrites all text options for labels and 


titles. These include: font, font size, text 
justification (left, right, or center), and 
formats. 


Others Overwrites all other options that are not color 
and text options. 


See /Global, earlier in this chapter, for a description of 
/Global, Keep. 


You store new charts and retrieve existing charts with Name, view 
them on the screen with View, and output them with Plot. To 
plot a hardcopy, you normally define the printing or plotting 
device using /Global, Graphics, Device from the main SuperCalc 
menu. You can also select additional output drivers and monitor 
and output options using //Graphics, Global, which is discussed 
later in this chapter. 


You can also load a chart from a spreadsheet on disk using 
/Load, Grapbics. To load a chart from a spreadsheet on disk 


Enter: 


/Load filename.cal,Graphs,chartname 
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You save chart descriptors when you save the spreadsheet using 
the /Save command. You can save an unlimited number of chart 
descriptors per spreadsheet. 


//Graphics Menus 


All data and attributes are defined in fill-in-tbe-blank menus. You 
cursor around the menu and fill in or select the necessary 
information in fields. These menus may extend beyond one 
screen, indicated by an arrow in the top-right corner of the 
screen. In this case, you can page-up (PgUp), page-down 
(PgDn), page-right (Ctr Right Arrow), and page-left (Ctri-Left 
Arrow) between screens. 


Making a Field Entry 


To enter data or attribute options, you'll use either entry or 
selection fields. An entry field accepts any allowable value, and a 
selection field accepts one of several choices shown in a Select 
window (press Return to see the window). If you’re not sure 
what kind of field you’re in, press Return. A selection field will 
display the Select window. 


Entry Fields 


In entry fields, you can always enter spreadsheet references, or in 
most cases, you can enter information directly in the field. The 
type of field determines what information is accepted. The rules 
for making entries in entry fields are: 


m When a range is expected, indicated by the word Range in 
the field name, only spreadsheet references are accepted. A 
spreadsheet reference must be a cell, range, or valid named 
range. You cannot use only a column range (A) or a row 
range (1). 


You can enter the reference by typing the cell, range, or 
named range directly in the field, or by pressing F4 to point 
to the range in the current spreadsheet. Pressing F3 displays 
the Named Range Directory in which you can select the 
named range. 
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You can define more than one series with a single data entry 
using a block range, which is two or more columns and rows. 
This data is interpreted as separate contiguous series (series 1, 
series 2, series 3...), either row-wise or column-wise. (See 
Series Range in the //Graphics, Data section for a discussion of 
row-wise and column-wise.) For example, if you define the 
block range to be A1:C7 in series 1, data is interpreted as 
three series: A1:A7, B1:B7, and C1:C7. 


When a value or text is expected, you can enter the actual 
value or text directly, or use a spreadsheet reference that 
contains the value or text. 


Selection Fields 


In selection fields, you have a choice of five ways to change the 
displayed entry: 


Using the Select Window. 


Place the cursor in the field and press Return to display the 
Select window with a list of options. If there are more 
options than fit in the window, you can scroll through the 
options with the Up and Down Arrow keys and the PgUp 
and PgDn keys, or go to the top or bottom with the Home 
and End keys. You can also type the first few letters unique 
to the option name and it will appear highlighted at the top 
of the window. 


Select a choice in the Select window, by placing the cursor on 
the entry option and pressing Return. The selected option 
replaces the current entry. If you don’t want to select a 
window choice, Esc erases the window and returns you to 
the unchanged field. 


Using a spreadsheet reference. 
You can enter a spreadsheet cell, range, or named range by 
typing it directly, or pressing F4 to point to the range from 


the spreadsheet. Press F3 to select a named range from the 
Named Range Directory. 
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You can define attributes for more than one series with a 
single data entry using a partial column or partial row. The 
partial column or row is interpreted as one cell (containing an 
attribute) per series. For example, if you define the partial 
column A1:A10 for series 1 color, the color in Al is for series 
1, the color in A2 is for series 2, and so on. 


The spreadsheet reference can contain a number that 
corresponds to the option (such as Yes), or the name of the 
option itself. The numbers begin at zero (0), from the first 
position in the Select window down. Therefore, if the 
options in the Select window are No or Yes in that order, 
zero corresponds to No, and one to Yes. 


When Using Numbers for Options 


These numbers are only valid for this version of 
SuperCalc. When new options are added, the 
numbering may change. Use strings (Yes) to 
guarantee version independence. 


m Cycling the entry options. 


Cycle through the entry options on the selection field, by 
placing the cursor on the selection field and pressing the 

Spacebar. Each-time you press the Spacebar, a different 
option displays. 


m Typing an entry. 


Place the cursor in the field and type the exact option name 
as it appears (either uppercase or lowercase) in the Select 
window. The cursor moves to the entry line for your entry. 
When you press Return, the new entry replaces the current 
entry. 
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NH Editing the entries. 


You can edit an entry by pressing the F2 Edit key and editing 
the entry in the same way you would edit an entry for the 
spreadsheet. Pressing Return displays the new entry. 


If you want to restore an entry to the default, place the cursor on 
the field and press Del. 


Function Keys 


The following function keys are useful when in //Grapbics: 


F1 Displays context-sensitive AnswerScreen help. 
F2 Lets you edit an entry in a menu. 

F3 Displays a list of chart descriptors. 

F4 Lets you point to the current spreadsheet from 


a graphics menu field to enter data. 


F5 Toggles data range between Row-wise and 
Column-wise. 


F6 Copies an attribute across all series. 
F10 Displays the current chart. 
Alt-F10 Plots the current chart on the last selected 


device — either a printer or plotter. See 
//Graphics, Plot for details. 


Ctrl Right Moves the cursor right one screen if a menu 
Arrow contains more than one screen, indicated by 
the right arrow in the upper-right corner. 
Ctr-Left Moves the cursor left one screen if a menu 
Arrow contains more than one screen, indicated by 


the left arrow in the upper-right corner. 


Del Clears the field and restores the global default. 
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End Goes to the bottom of the current menu or 
Select window. In EDIT mode, goes to the 
end of the text string. 


Esc Returns to the previous //Graphics menu 
level, or exits from the Select window. 


Home Goes to the top of the current menu or Select 
window. In EDIT mode, goes to the 
beginning of the text string. 


PgDn Pages down within the current menu if it 
extends beyond one screen, indicated by the 
down arrow in the upper-right corner. 


PgUp Pages up within the current menu if it extends 
beyond one screen, indicated by the up arrow 
in the upper-right corner. 


Return Displays a Select window of options for the 

field under the cursor, or accepts a value for a 

field. his 
//Graphics, View 


Displays the current chart on screen. You can also press F10. 
When you're finished viewing the chart, press any key and you 
are returned to where you were before viewing. 


//Graphics,Type 


Selects the main chart type. When you select Type, the menu line 
displays these types: Bar, Pie, Dual, Line, Area, Hi-Lo, X-Y, 
Radar, Word. 


All chart types (except Pie and Hi-Lo) have variations of that type. 

Selecting the main chart type selects the default chart variation 

and attributes. You can change the defaults by selecting Options. os 
See //Graphics, Options for further details. 
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To make your changed defaults the program defaults for all work 
sessions, use /Global, Keep. 


//Graphics,Type,Bar 


Selects the default Bar chart type. There are five Bar chart types: 
Simple-Bar (the default), Stacked-Bar, Grouped-Bar, 100%-Bar, 
and Delta-Bar. To change the type and attributes, select 
//Grapbics, Options to display the Chart Options Menu, and 
change the chart type in the Type field. 


The appearance and application of each Bar chart type is 
described and illustrated as follows: 


Simple-Bar Chart 


Description — The Simple-Bar chart has two axes. The horizontal 
(X) axis represents the number of data points in the series range 
(columns or rows), and the vertical (Y) axis represents the 
magnitude of each of these points. 


The number of bars per cluster is equal to the number of series. 


There can be one X-axis label per data point, and one data point 
label for each item in the series. Negative values are plotted. 
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Application — A Simple-Bar chart can be used for several 
applications. It is effective for comparing a small number of 
categories or a single category over a small number of time 
periods. Simple-Bar charts are especially effective when showing 
large changes from one subject category or time period to the 
next. 
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Stacked-Bar Chart 


Description — The Stacked-Bar chart uses all of the series ranges 
associated with the current chart, and accumulates them (1 + 2 + 
..+ 10) in a single stacked bar. 


A stacked bar has two axes. The horizontal (X) axis represents 
the number of data points (columns or rows in the data series 
range), and the vertical (Y) axis represents the magnitude of the 
sum of all series in that stacked bar. The number of stacks is 
equal to the number of series, and the number of bars is equal to 
the number of points in each series. 
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Values in a Stacked-Bar 


The stacking direction (either positive or 
negative) is determined by the sign of the first 
non-zero value in each bar. For example, if the 
data values were 4, 7, -3, and 5, the bar would 
show only the three positive values. If the data 
values were -5, 3, -4, and 7, the bar would show 


only the two negative values. 


Application — The Stacked-Bar chart is effective in comparing 
multiple measurements over a period of time. 
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Grouped-Bar Chart 


Description — The Grouped-Bar chart combines the attributes of 
the Simple-Bar chart and Stacked-Bar chart. Two or more series 
can be stacked into single bars and then grouped into clusters of 
bars. See //Graphics, Options to learn how to specify Group/Stack 
#, 
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Application — Grouped-Bar charts are effective for comparing the 
combined performance of some series to individual measurements 
of others; or comparing the combined performance of one set of 
series with the combined performance of another set of series. 


Software Sales 
By Percent of Regional Sales 
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Description — The 100%-Bar chart appears like a Stacked-Bar 
chart where each series in a bar represents a percentage of the 
whole bar, which is 100%. Each bar is the same height along the 
top of the chart. The number of stacks is equal to the number of 
series, and the number of bars is equal to the number of points in 
each series. 
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Application — 100%-Bar charts are helpful when comparing 
proportions over time. 
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Delta-Bar Chart 


Description — The Delta-Bar chart is similar to a sorted Simple- 
Bar chart with 100% overlap. The bars are superimposed -- 
similar to placing one bar behind the other, from the smallest to 
the largest. 


SuperCalc Commands 2-233 


//Graphics 


Application — The Delta-Bar chart is effective for comparing 
differences between series over time. 


BLACK HAWK WINERY 
($ Thousands) September Sales 
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//Graphics,Type,Pie 


Selects a Pie chart, which presents data as an entire pie, separated 
into segments. You can change its attributes in the Chart Options 
Menu for Pie charts by selecting //Graphics, Options after selecting 
Pie as the chart type. 


The appearance and application of the Pie chart is described and 
illustrated as follows: 


Pie Chart 


Description — A Pie chart is a one-dimensional chart that can 
represent only one set of data, either all points of a single series, 
or a single point of all series. Series 1 is the default. If you have 
defined several series ranges, you can plot the pie as all points of 
one series, or as one point from all series. Negative values are 
not plotted. 


The percentage of the total pie that each data point (spreadsheet 


cell) represents is placed alongside its segment of the pie as a 
segment label. To suppress the segment labels, choose None for 
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the Segment Labels Display field in the Chart Options Menu for 
Pie charts. 


Application — Pie charts are the best choice for illustrating 
percentages or parts of a whole. SuperCalc lets you explode 
segments of your Pie chart to highlight specific data. See the 
Chart Options Menu for Pie Charts section for details. 
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//Graphics,Type,Dual 


Selects the default Dual chart type. There are four Dual chart 
types: Pie-Pie, Pie-Bar or Bar-Pie, and Bar-Bar. To change the 
type and its attributes, select //Graphics, Options. 


Description: Each Dual chart type presents two sets of data 
(either related or unrelated) as two separate charts. One chart 
can represent a breakdown of a segment from the other chart. 
Related charts are often linked to show the relationship of the 
two. 


SuperCalc Commands 2-235 


//Graphics 


Application: Dual charts are effective for showing the larger parts 
of a whole, and a breakdown of one of the parts, or two sets of 
data as different charts. 
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//Graphics,Type,Line 


Selects the default Line chart type. There are two types: Simple- 
Line (the default), and Stacked-Line. To change the type and its 
attributes, select //Graphics, Options. 


The appearance and application of each Line chart type is 
described and illustrated as follows: 


Simple-Line Chart 


Description — A Simple-Line chart uses all the series ranges 
defined for the current chart. The horizontal (X) axis represents 
the number of data points (columns or rows) in the data series 
range, and the vertical (Y) axis represents the magnitude of each 
of these points. 


The number of lines is equal to the number of series defined. 
You can mark the data points on a line chart with markers, 
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connect them with lines, and specify a line fitting algorithm to use 
(see Chart Options Menu for Line Charts for more information). 


You can also specify a line chart without lines or markers. In this 
type of chart, you would normally mark the data points with data 
labels. See the //Grapbics, Labels, Data-labels section for a 
discussion of data labels. 


Application — Simple-Line Charts are effective for showing trends 
for several series over many time intervals. Simple-Line charts are 
also effective for contrasting pairs of related series such as 
planned vs actual sales performance. 
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Stacked-Line Chart 


Description: A Stacked-Line chart is to the Simple-Line chart as 
the Stacked-Bar is to the Simple-Bar chart. The Stacked-Line chart 
accumulates all the series for each period (series 1 + series 2..+ 
series 10) in a single line. The number of lines is equal to the 
number of series defined, and the number of markers for each 
line is equal to the number of data points in each series. Negative 
values are considered to be zero. 
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Application: The Stacked-Line chart is effective for showing 
accumulating trends. 
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//Graphics,Type,Area 


Selects the default Area chart type. There are two chart types: 
Simple-Area (the default), and Stacked-Area. To change the type, 
select //Graphics, Options. 


Simple-Area Chart 


Description — The Simple-Area chart can be visualized as a filled- 
in Simple-Line chart. The number of areas is equal to the number 
of series defined. 
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Application — The Simple-Area chart is effective for comparing 
volume measurements. This chart is best used to emphasize 
quantities rather than indices. 


Annual Sales By Region 
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Stacked-Area Chart 


Description — Presents data as a filled-in Stacked-Line chart. It 
similarly accumulates all series for each time period and adds a 
shaded area layer for each series. The X-axis represents the 
number of data points, and the Y-axis represents the cumulative 
magnitude of all the series in each row or column. The number 
of areas is equal to the number of series defined. Negative values 
are considered to be zero. 
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Application — The Stacked-Area chart is effective for comparing 
cumulative volume measurements. 
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//Graphics,Type,Hi-Lo 


Selects the Hi-Lo chart type. You can change its attributes in the 
Chart Options Menu for Hi-Lo charts by selecting 
//Graphics, Options after selecting Hi-Lo as the chart type. 


The appearance and application of the Hi-Lo chart is described 
and illustrated as follows: 


Hi-Lo Charts 


Description — The Hi-Lo chart shows the spread between the 
highest and lowest measurements of a series above each time 
interval. Typically, a vertical line connects each series pair, but 
you can display just the data point markers. In a Hi-Lo chart, 
SuperCalc expects all the high values to be in series 1, and all the 
low values in series 2. All other specified series (such as open 
and close) are plotted along a vertical line 
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Application — The Hi-Lo comparison is especially useful in 
tracking a range of measurements over time such as stock market 
or competitive pricing. 
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//Graphics,Type,X-Y 


Selects the default X-Y chart type. X-Y charts, also called Scatter 
Plots, are line charts that have no explicit time element. Since 
there is no explicit time element, axis labels do not apply. An X- 
Y chart may be thought of as three-dimensional. Both the X-axis 
and Y-axis are numeric. The third dimension (time) is implied by 
the order in which the points are plotted. 


There are two X-Y chart types: XYY (the default) and XYXY. To 
change the type and attributes, select //Graphics, Options. In an 
X-Y chart, some options (such as Axis Scaling options) that 
normally apply to Y-axes only, may be specified for the X-axis as 
well. 


Description — An X-Y chart plots either a minimum of two 


additional series against the first series (XYY chart), or plots pairs 
of series against each other (XYXY chart). 
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Application — X-Y charts are effective for viewing data 
relationships. 
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//Graphics,Type,Radar 


Selects the default Radar chart type. The Radar chart is a 360- 
degree axis chart that displays data in polar coordinates — angle 
vs. radius. There are two Radar chart types: XYY (the default 
and XYXY. To change the type and its attributes, select 
//Graphics, Options after selecting Radar as the chart type. 


Description — A Radar chart plots either series 1 as the angle 
against all other series as the radiuses, or pairs of series against 
each other where the first series is the angle and the second is the 
radius. Angles are specified in radians. To convert degrees to 
radians, multiply by PI/180. Angles greater than 2*PI (360 
degrees) wrap (all angles are modulo 2*PI). 


2-242 SuperCalc Reference Manual 


//Graphics 


Application — A Radar chart is used for scientific and 
mathematical applications. The following example plots series 1 
against series 2. 


//Graphics,Type, Word 


Selects the Word chart type. You can choose one of three 
variations of the basic word chart: 1-Column, 2-Column, and 3- 


Column. 


Description: Word charts are text blocks consisting of single lines 
in one, two, or three columns. 
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Application — A Word chart is best used for text formats, such as 
single paragraphs, bulleted lists, outlines, tables, etc. 


Expansion Justification 


& Limited office space. 
w Triple the manpover by 1990, 


E Limited space for neu equipment. 


//Graphics,Data 


The Data command displays the Chart Data and Options Menu. 
There are two types of Data menus, one for numeric charts (axis 
and Pie charts), and one for textual charts (Word charts). 


2-244 SuperCalc Reference Manual 


//Graphics 


Chart Data and Options Menu for Numeric Charts 


Lets you enter series ranges for the data, and change the series 
options. This menu has columns for ten series across. A series 
corresponds to a partial row or column in the spreadsheet. 


SERIES RANGE 


SERIES OPTIONS E : 
Color Red : Blue Orange 
Hide No | - No No 
Fill Pattern NarrowSlant MediumSlant WideSlant NarrowHatch MediumHatch 
Outline Color Black - Black - Black - Black - Black 
Outline Style Solid - Solid - Solid - Solid Solid 
Outline Width Thin - Thin - Thin - Thin - Thin 
Y-Axis Left Left Left Left Left 
Pie Explosion No - No - No - No No 


Series Range 


Lets you specify a series (data) cell, range, or named range to 
chart. You can enter the range directly or press F4 to select a 
range in the spreadsheet. When you select a block range and 
press Return, (R) or (C) displays next to the range. These stand 
for row-wise and column-wise. 


SuperCalc interprets the block to define more than one series. 


This is a great convenience when several series are placed 
contiguously in the spreadsheet. 
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SuperCalc determines these series to be row-wise if there are 
more columns than rows in the range, or if there are an equal 
number of each. For example, the following data block range has 
five columns and two rows, defining two series as row-wise. one 
for Row 3 and one for Row 4. 


158 208 388 258 


358 258 198 288 


Row-wise 


If there are more rows than columns, the series are defined as 
column-wise. For example, the following data block range has 
five rows and two columns, defining two series as column-wise: 
one for column A and one for Column B. 


Column-wise 


You can change how the series is defined by pressing F5, which 
changes (R) to (C) and vice versa. F5 works for partial columns 
and rows as well as ranges. Changing a partial column to row- 
wise makes several one-cell series. 


If you select a range that has more than ten series, that whole 
range displays on the chart. You can define attributes beyond ten 
series by using a range, but you can only explicitly define 
attributes for the first ten series. 


When a range is entered, only the range displays in the Series 


Range field. If conflicting ranges are entered (the data in one 
overlaps the other), the right-most range takes precedence, 
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overruling the previous range, beginning with the series in which 
the second range is located. 


For example, there are two conflicting ranges in the following 
Chart Data Appearance and Options Menu. The second range, 
D1:F5, will overrule the first range, A1:C10. 


Therefore, series 1 will still have values for A1:A10, but the other 
series will have values from the second range: series 2 will have 
values for D1:D5, series 3 for E1:E5, and series 4 for F1:F5. 


CHART DATA APPEARANCE AND OPTIONS MENU TYPE: BAR > 
3 4 5 


1 | 2 
SERIES RANGE A1:C18(C) D1i:FS(C) 


SERIES OPTIONS 

Color 9LtBlue - 1BLtGreen  11LtCyan 12LtRed 13LtMagent 
Hide No No - No No No 

Fill Pattern MediumSlan  MediumHori MediumVert MediumHatc  MediunCros 
Outline Color Black - Black - Black Black - Black 
Outline Style Solid Solid - Solid Solid Solid 
Outline Width Auto Auto - Auto Auto Auto 
Y-axis Left Left - Left Left Left 

Pie Explosion No - No - No No No 


Series Options 


Color Specifies the color of each series. See Colors, 
at the end of the /Grapbics section, for a list 
of colors. 

Hide Specifies whether the series is displayed. 

m Yes — Displays the series data. 


A No — Hides the series data. 


Fill Pattern Specifies the fill pattern of each series. To see 
the list of options, display the Select window. 


Outline Specifies the outline color of each series. 
Color None does not display the outline. 
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Outline Style 


- Outline 
Width 


Y-Axis 


Pie 
Explosion 


Specifies the style (solid, dashed, etc.) of the 
outline. To see the list of outline style 
options, display the Select window. 


Specifies the width of the outline. To see the 
list of outline width options, display the Select 
window. 


Specifies whether the series is plotted against 
the left Y-axis (Y1-Axis in other menus) or the 
right Y-axis (Y2-Axis). 


Specifying all series as Left displays the Y-axis 
on the left side of the X-axis. 


Specifying all series as Right displays the Y- 
axis on the right side of the X-axis. 


Specifying some series as Left and others as 
Right displays two Y-axes, which creates a 
dual-axes chart. See //Global, Axis for 
information on scaling dual-axes charts. 


Specifies which points or series will be 
exploded when you select List for Explosion 
Type in the Chart Options Menu for Pie 
charts. See the Chart Options Menu for Pie 
Charts section for details. 


Ñ Yes — Explodes the point or series 
when List is specified in the Chart 
Options Menu for Pie charts. 


E No — Does not explode the series. 
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Word Chart Data and Options Menu 


Lets you specify the range or valid range name that contains the 
text, and the text appearance options. 


COLUMN 2 COLUMN 3 
WORD DATA RANGE 


WORD OPTIONS 
Color Black Black Black 
Font Stick Stick Stick 
9 e e 


512e : 8 
Justify Left Left Left 
Indent z] B g 
Hanging Indent B : B y 
Paragraph Bullet Filled-b Filled-b Filled-b 
Line Bullet Filled-b : Filled-b Filled-b 


Word Data Range 


Lets you specify a cell, range, or named range containing the text 
for the Word chart. You can enter the range directly or press F4 
to select a range in the spreadsheet. The first line in a range 
specifies the data as a paragraph. A range can contain multiple 
paragraphs separated by blank cells. 


Word Options 


Color Specifies the text color. 


Font Lets you specify a font type. SuperCalc 
supports 16 fonts. To see the list of fonts, 
display the Select window for Font or press 
F1 for help. 


Size Specifies the text size: 1-20, from smallest to 


largest. Auto is the default size, which is 
calculated by SuperCalc. 
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Justify 


Indent 


Hanging 
Indent 


Paragraph 
Bullet 


Specifies whether the text is left-justified, 
centered, or right-justified. 


€ Left — Left-justifies the text, with a 
ragged-right margin. 


Ed Center — Centers the text within the 
column. 


s Right — Right-justifies the text with a 
ragged-left margin. 


Specifies how many characters a paragraph is 
indented. Indent works as follows: 


If the paragraph is left-justified, Indent moves 
it to the right. 


If the paragraph is right-justified, Indent 
moves it to the left. 


If the paragraph is centered, Indent is 
ignored. 


Specifies the number of characters that 
paragraph lines other than the first are 
indented. A hanging indent is one in which 
the first line hangs out over the remaining 
lines. The rules for Indent also apply for 
Hanging Indent. 


You create a hanging indent (like this 
paragraph) by using a Hanging 
Indent value larger than 0. For 
instance, this left-justified paragraph 
has a Hanging Indent value of five. 


Specifies the type of bullet to use for a 
paragraph. To see the list of bullet types, 
display the Select window. 
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Line Bullet Specifies the type of bullet to use for a line. 
Display the Select window to see the list of 
bullet types. 

//Graphics,Labels 


Lets you specify labels and titles. When you select 
//Graphics,Labels, the menu line shows the following options: 
Quit, Axis-labels, Legend-labels, Data-labels, Titles. 


Each command leads to the corresponding Definition and Options 
Menu for defining the labels and titles and their attributes. 


//Graphics,Labels,Axis-labels 


Lets you specify the range that contains numbers or text that mark 
the X-axis ticks, the available axis label appearance options, and 
chart box and axis box options. Selecting Axis-labels displays the 
Axis Label Definition and Options Menu. 


Y1-AXIS o YZ-AXIS 


X AXIS LABEL RANGE 


AXIS LABEL OPTIONS 
Color Black Black Black 
Font Stick : Stick Stick 
Size 3 3 ce 
Justify Left : Left Left 
Format General General General 
Date Format General General General 


CHART BOX 
Color Gray 
Outline Color White 


AXIS BOX 
Color White 
Outline Color Black 


X-Axis Label Range 


Lets you specify the X-axis label range or named range. You can 
enter the range directly or press F4 to select a range in the 
spreadsheet. 
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Axis Label Options 


Color Lets you specify a label color. 


Font Lets you specify a label font type. SuperCalc 
supports 16 fonts. To see the list of fonts, 
display the Select window for Font or press 
F1 for help. 


Size Specifies the text size: 1-20, from smallest to 
largest. Auto is the default size, which is 
calculated by SuperCalc. 


Justify Lets you specify whether the label is left- 
justified, centered, or right-justified. 


a Left — Left-justifies the text, with a 
ragged-right margin. 


E Center — Centers the text. 


Ñ Right — Right-justifies the text with a 
ragged-left margin. 


Format Lets you select a numeric display format. See 
/Format, earlier in this chapter, for 
explanations of each of these options. The 
options are: 


General 
Integer 
Exponential 


S 
User-defined 1-8 
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Chart Box 
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Specifies the type of date format. Dates are 
usually used as X-axis labels if the X-axis 
range contains date values. There are eight 
options that correspond to the user-defined 
date and time formats set with /Format. See 
/Format for more information. To see the list 
of date format options, display the Select 
window. 


Specifies the background color and outline color for the chart 
area outside the axes boundary. You can specify one or both 


options to display. 


Fill Color 


Outline 
Color 


Axis Box 


Specifies the background color of the chart 
outside the axes boundary. None does not 
display a background color. See Colors at the 
end of the //Grapbics section for a list of 
available colors. 


Specifies the outline color of the chart box. 
None does not display the outline. 


Specifies the background color, outline color, and outline width 
for the area within the axes boundary. You can specify one, two, 
or all options to display. 


Fill Color 


Outline 
Color 


Outline 
Width 


Specifies the background color of the chart 
within the axes boundary. None does not 
display the background color. 


Specifies the outline color of the axis box. 
None does not display the outline. 


Specifies the width of the outline. Display the 


Select window to see the list of options. Auto 
is the default. 
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//Graphics,Labels,Legend-labels 


Lets you specify the legend labels (which are usually the series 
names), the location, and appearance options. Selecting Legend- 
labels displays the Legend Label Definition and Options Menu 


LEGEND LABEL RANGE 


LEGEND LOCATION 
Position Upper-Right 
Placenent Outs ide 


LEGEND LABEL OPTIONS 
Color Black 
Font Stick 
Size 


6 
Justify Left 
Format General 
Date Format General 


LEGEND BOX 
Display Yes 
Color White 
Outline Color Black 


Legend Label Range 


Lets you specify the cell, range, or named range for the legend 
labels. You can enter a range directly, or press F4 to select a 
range from the spreadsheet. 


Legend Location 
Position Positions the legend in a specific area of the 
chart. 
a Top — Selects a top-center legend 
position. 
a Bottom — Selects a bottom-center 


legend position. 


~—— 


E Right — Selects a right legend 
position. 
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z Left — Selects a left legend position. 


ES Upper-Right — Selects an upper-right 
corner legend position. 


E Lower-Right — Selects a lower-right 
corner legend position. 


z Upper-Left — Selects an upper-left 
corner legend position. 


= Lower-Left — Selects a lower-left 
corner legend position. 


Placement Specifies where the legend is placed. 
Be Inside — Places the legend inside the 
axis box. 


z Outside — Places the legend outside 
the axis box. 


Legend Label Options 
For choices of the following options, see Axis Label Options: 


Color 

Font 

Size 

Justify 
Format 

Date Format 


Legend Box 


Display Specifies whether or not the legend box is 
displayed. 


2 Yes — Displays the legend. 


# No — Does not display the legend. 
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Color Specifies the background color of the Legend 
box. See Attribute Options at the end of the 
//Grapbics section for a list of available colors. 


Outline Specifies the outline color of the Legend box. 
Color 


//Graphics,Labels,Data-labels 


Lets you specify data labels and options that correspond to the 
data in the Chart Data and Options Menu. Selecting Data-labels 
displays the Data Label Definition and Options Menu. 


1 2 3 4 5 
DATA LABEL RANGE 


DATA LABEL OPTIONS 
Location Table 
Placenent Inside 
source Range 
Color Black 
Font Stick 
Size 3 
Format General 
Date Format General 


Data Label Range 


Specifies the series range for data labels if you want to use labels 
other than the data values from the Chart Data and Options Menu. 
You enter the range directly, or press F4 to select a range from 
the spreadsheet. 
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Data Label Options 

Location Specifies how the data labels are displayed. 
z None — Does not display data labels. 
a Point — Displays the data labels at the 


data points. 


a Table — Displays data labels in a table 
underneath the chart. 


Placement Specifies where the data labels are placed for 
Bar, Pie, and Dual charts. 


g Inside — Places the data labels inside 
the bars or pie segments. 


E Outside — Places the data labels 
outside the bars or pie segments. 


Source Specifies the source of the data labels and 
whether data labels are displayed: Range and 
Data. 


a Range — Uses the Data Label Range 
values in this menu. 


a Data — Displays the data from the 
Chart Data and Options Menu as the 
data labels. 


For choices of the following options, see Axis Label Options: 


Color 

Font 

Size 

Justify 
Format 

Date Format 
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//Graphics,Labels, Titles 


Lets you specify the chart titles and their attributes. Titles has two 

menus: the Title Definition Menu, which defines the titles; and 

the Title Options Menu, which defines the title attribute options. sae 
To access the second menu, press PgDn from the first menu. 

Press PgUp to return to the first menu, and Esc to return to the 

//Graphics, Labels menu. 


Title Definition Menu 


Lets you define five types of titles: Top Title, Subtitle, Footnote, 
Axis Titles, and Legend Title. You can enter a range directly, 
press F4 to enter a range from the spreadsheet, or type in the 
actual titles Cup to 80 characters). 


When a previous version of a SuperCalc chart is imported, the 


main title appears in the Top Title 1 field, and the subtitle appears 
in the Subtitle 1 field. 


TOP TITLE 


SUBTITLE 


FOOTNOTE 


AXIS TITLES 
X-Axis 
¥1-Axis 
¥2-Axis 


LEGEND TITLE 


Top Title Lets you specify the main title, which is 
usually the largest title, and is at the top of 
your chart. You can enter up to three lines 
for the top title. 
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Subtitle Lets you specify the subtitle, which is usually 
smaller than the top title. This title is directly 
below the top title. You can enter up to two 
lines for the subtitle. 


Footnote Lets you specify the footnote title. This title is 
the smallest by default, and is left-justified at 
the bottom of the page. You can enter up to 
three lines for the footnote. 


Axis Titles Lets you specify X-axis and Y-axis titles. You 
might want X-axis and Y1-axis titles for an X- 
Y chart, and two Y-axis titles for a dual Y-axis 
chart. 


Legend Title Lets you specify a legend title that defines the 
legend labels. This title is centered at the top 
of the legend by default. 


Title Options Menu 


Lets you change the attribute options for each type of title. For 
titles that can have two or three lines, the defaults are the same 
for all the lines. 


JUSTIFY POSITION 
TOP TITLE i Center 


| SUBTITLE Center 


FOOTNOTE i Left 


AXIS TITLES 
X-Axis i Center 
¥1-fAxis i Center Hor izonta | 
¥2-Axis Center Vertical 


LEGEND TITLE i Center 
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For choices of the following options, see Axis Label Options: 


Color 
Font 
Size 
Justify 
Position For Y-axis titles only; specifies whether the 
title is Horizontal or Vertical. 
E Horizontal — Displays the Y-axis title 
left to right, above the axis. 
= Vertical — Displays the Y-axis title 
top-to-bottom, along the axis. 
//Graphics,Axis 


Lets you specify the axis scaling and the axis attribute options. 
Axis has two menus: The Axis Scaling Definition Menu, which 
defines the axis scales; and the Axis Options Menu, which defines 
the axis attributes. To access the second menu, press PgDn from 
the first menu. Press PgUp to return to the first menu, and Esc to 
return to the //Grapbics menu. Axis is applicable to axis charts 
only, such as Bar, Line, Area, X-Y, Hi-Lo, and Radar. 


Axis Scaling Definition Menu 


Lets you define the axes scales for the X-axis and Y-axes, 
depending on the chart type you're using. The default is Auto, in 
which SuperCalc calculates the chart scaling. 
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If you define the Y2-axis scale and your chart doesn’t have a 
second Y-axis, the values are ignored. The X-axis column is also 
ignored except when scaling an X-Y chart. 


z : ¥2-AXIS 
MODE re | Aita 
TYPE Log 
LOW VALUE B 
HIGH VALUE B 
MANUAL LABEL RANGE 


TICKS: 

NORMAL MAJOR 
Divisions 
Increnent 

NORMAL MINOR 
Divisions 
Increnent 

LOG MAJOR 
Decades/Division 
Divisions/Decade 

LOG MINOR 
Decades/Division 
Divisions/Decade 


Mode 


Specifies the type of scaling. 


Auto Automatically scales the axis or axes 
according to the low and high values if 
supplied. 

Manual Lets you manually scale your chart and enter 
labels. 

Zero Forces the axis to start at zero, unless negative 


values are included in the data range. In that 
case, Zero is the same as Auto. 
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Type 
Specifies how the axis is scaled. 
Normal Scales the axis evenly either by the 


incremental value (value between ticks) or by 
the number of divisions (space between 


ticks). 
Logarith- Scales the axis exponentially by the number 
mic of decades (each decade being a value that is 


a power of ten, i.e., 1, 10, 100,... between 
ticks) per division, or by the number of 
divisions per decade. 


Low Value 


Specifies the low value in Manual mode to define the low end 
(origin) of the axis scale. 


High Value 


Specifies the high value in Manual mode to define the high end 
of the axis scale. 


Manual Label Range 


Lets you enter your own range of labels for scaled major tick 
marks in Manual mode (X-axis only applies to X-Y charts). The 
range contains one label per major tick. 


Ticks 


In Manual mode, lets you specify the placement of the axis ticks 

(major and minor), rather than use the default tick placement for 

Auto mode. Major ticks mark the main scaling values on the axis 
and minor ticks mark the incremental values between major ticks. 
Major ticks have labels, while minor ticks do not. 


You specify either the number of divisions between major and 


minor ticks, or the value between ticks (Increment for Normal or 
Decade per Division for Log), but not both. Specifying one 


2-262 SuperCalc Reference Manual 


//Graphics 


automatically defines the other. When one is specified (you enter 
a value), the other value is blanked on the Menu. 


A division is the axis segment between ticks. An axis with one 
tick in the center has two divisions. 


Normal Specifies the Division or Increment for major 
Major ticks that are scaled in NORMAL mode. 
$ Division — Specifies the number of 


major divisions for the axis. 


38 Increment — Specifies the value 
between major ticks. 


You can only specify the Division or 
Increment, but not both. Specifying one 
defines the other. 


For example, if you have a scale from zero to 
ten, and you specify an increment of two, the 
axis will have five divisions or six major ticks. 


5 Division 
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Normal 
Minor 


<< Minor Tick 


Specifies the minor tick divisions and 
increment values that are scaled in NORMAL 
mode. 


e Division — Specifies the number of 
divisions within one major division. > 


e Increment — Specifies the value 
between minor ticks. 


The same rule for major ticks applies to minor 
ticks. 


Log Major 


Decades/ 
Division 


Log axis divisions may be specified either as 
Divisions/Decade or Decades/Division. A 
decade is one power of ten. 


In AUTO mode, the scale is one Decade per 
major Division. 


Specifies the number of decades per division 
for major ticks. 
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Divisions/ Specifies the number of labeled divisions per 
Decade decade. 


You can specify in Decades/Division or 
Divisions/Decade, but not both. Specifying 
one defines the other. The way you specify 
either value determines how the axis is 
scaled. 


The following examples show the difference 
in scaling for an axis scaled from one to 10. 


MaJjor Division 


MaJjor Division 


Major = 3 Decades/Division 
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Major Decade 


Major 
Division 


a 


Major = 9 Divisions/Decade 


We recommend that you have at least one decade per major 
division. 


Log Minor Specifies the minor tick divisions between 
major ticks in LOG mode. — 
Decades/ Specifies the number of decades per division 
Division for minor ticks. 
Divisions/ Specifies the number of unlabeled divisions 
Decade per decade. 


We recommend that you have either one 
Division per Decade, or nine minor Divisions 
per Decade (eight minor ticks) between major 
ticks. You cannot have more than one 
Division per Decade for both major and minor 
ticks. 


The same rule for major ticks applies to minor 
ticks. See the following examples. 
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ae Decade 
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Major = 3 Decades/Division 
Minor = 1 Decade/Division 


Major and Minor Decade 
Major Division 


Major and Minor Decade 


Major Division 


A iv is ion 


Major = 1 Decade/Division 
Minor = 9 Divisions/Decade 
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When defining values for decades and 
divisions, be sure the values make sense. It’s 
easy to create a chart that is wrong but looks 
right — especially for minor ticks since they 
are not labeled. 


For example, the following chart shows the 
recommended number of decades and 
divisions possible for a logarithmically-scaled 
chart with four decades. 


Major Minor 

1 Dec/Div 1, 9 Div/Dec 

2 Dec/Div 1, 9 Div/Dec or 1 Dec/Div 

4 Dec/Div 1, 9 Div/Dec or 1, 2 Dec/Div 


Axis Options Menu 


Lets you change the attribute options for the axes, grids, and tick 
marks. 


AXIS OPTIONS MENU a TYPE: BAR ft 
COLOR WIDTH STYLE POS ITION 


X-AX IS o 
Axis la Thin Solid 
Tick Thin Outside 
Ma jor Thin Solid 
Minor Thin Solid 


Y1-AXIS 


Axis Thin Solid 
Tick Thin Outs ide 
Ma jor Thin Solid 
Minor Thin Solid 


Y2 AXIS 
Axis Thin Solid 
Tick Thin Outside 
Ma jor Thin Solid 
Minor Thin Solid 


2-268 SuperCalc Reference Manual 


//Graphics 


Color Specifies a color for the axis line, grids, and 
ticks. Display the Select window to see a list 
of colors. 

Width Specifies the axis, grid, and tick line width. 


Display the Select window to see a list of 
width options. 


Style Specifies the axis line and grid style (solid, 
dashed, etc.). Display the Select window to 
see a list of grid style options. 


Position Specifies the position of the ticks. 

Inside — Places the ticks inside the 
axis boundary, just touching the axis 
line. 

E Outside — Places the ticks outside the 
axis boundary, just touching the axis 
line. 


E Both — Straddles the ticks on the axis 
line so they are both inside and outside 
the axis boundary. 


//Graphics,Options 


Specifies the chart type variation and series options for each major 
chart type: Bar, Pie, Dual, Line, Area, Hi-Lo, X-Y, Radar, and 
Word. 


//Graphics, Options displays the Chart Options Menu for the 
selected major chart type. If no type has been selected, Bar is the 
default. The current chart type appears in the upper-right corner 
of the screen. 
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Chart Options Menu for Bar Charts 


Specifies the changeable attribute options for Bar charts. 


BAR OPTIONS 
Group/Stack $ 
Bar/Line 


BAR/LINE OPTIONS 
Fit Type Connect — - Comect Connect 
Line Style Solid i Solid = Solid 
Line Width Thin j Thin Thin 


Marker Type Cross x DounTri 
Marker Size 5 -9 5 


TYPE 
HORIZONTAL 


Bar Options 
Group/ For Grouped-Bar only. Specifies the group in 
Stack # which the series is placed and in what order 


the series is stacked. 


For example, in the following Grouped-Bar 
chart, one (1) is entered for series 1 and 2, 
making the first stacked-bar (group 1) in each 
cluster series 1 on the bottom and series 2 on 
top. Two (2) is entered in series 3, making 
the second bar in each cluster series 3 only. 
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Software Sales 
By Percent of Regional Sales 


Bar/Line Specifies whether the series is plotted as a bar 
or a line. This layout combines both bars and 
lines on a single chart. 


5 Bar — Draws the series as bars. 
BS Line — Draws the series as a line. 


This is effective when representing a 
cumulative measurement with a line and 
individual time measurements with bars; or 
when emphasizing one series against a 
background of related series. 
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MegaTech Cuts Into the Competition 


Bar/Line Options 


Fit Type Specifies the way the data points fit to the 
line. The possible choices are: 


E Connect — Draws a straight line 
connecting points. 


E Stepped — Connects data points with 
a series of horizontal and vertical lines. 


G Average — Draws a best-fitting 
horizontal straight line through data 
points. 

z Linear — Draws a best-fitting straight 


line (a trend line) between points. 


æ Quadratic — Draws a smooth segment 
of a parabola. 


x Cubic — Draws a smooth segment of a 
third order polynomial between points. 
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a Polynomial — Connects data points 
with a best-fitting curved line. 


Regarding Line Fit 


Selecting Quadratic, Cubic, or Polynomial line fit 
may cause the line to exceed the boundary of the 
axis system. To correct this, scale the Y-axis on 
the /Grapbics, Axis Axis Scaling Definition Menu. 


Line Style Specifies the style of the line. To see the list 
of options, display the Select window. 


Line Width Specifies the width of the line. Display the 
Select window to see the options. 


Marker Type Lets you select a symbol to mark the data 
points on Bar/Line charts. There are ten 
possible symbols. Display the Select window 
to see the list of symbols. 


Marker Size Specifies the size of the marker: 1-5, from 
smallest to largest. Auto is the default size, 
which is calculated by SuperCalc. 


Type 


Specifies a variation of a Bar chart type. 


Simple The X-axis represents the number of data 
points, and the Y-axis represents the 
magnitude of each series in each cell. The 
number of bars per cluster is equal to the 
number of series plotted. 
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Stacked Uses all the series ranges associated with the 
current chart, and accumulates them (series 1 
+ series 2..+ series 10) in a single stacked bar 
per time period. The number of stacks is 
equal to the number of series. 


Grouped Presents data as clusters of stacked bars 
(combining attributes of Simple-Bar and 
Stacked-Bar charts). Among a cluster of bar 
measurements, two or more series can be 
stacked into a single bar. 


100% Presents data like a Stacked-Bar, except each 
series in a bar represents a percentage of all 
the series in the stacked bar, which add up to 
100%. The number of bars/stack is equal to 
the number of series, and the number of 
stacks is equal to the number of points in the 
series. 


Delta Presents data as superimposed bars, showing 
the difference between the series. This is 
similar to placing one bar behind the other, 
from the smallest to the largest. 


Horizontal 
Specifies whether the data is displayed horizontally or vertically. 
Yes Presents the data horizontally, left to right; 


larger Y-axis values appear on the right, 
smaller on the left. 


No Presents the data vertically, bottom-to-top; 


larger Y-axis values appear on the top, 
smaller on the bottom. 
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3D 


Specifies whether or not the chart is displayed in three- 
dimensional perspective. 


Yes Presents charts in three-dimensional 
perspective. 

No Presents charts as two-dimensional. 

%Overlap 


For 2-dimensional Bar charts, specifies the amount of space 
overlapped by bars in a cluster. The options are -100% to 100%. 
25 overlaps each bar 25% of one bar's width. Negative overlap 
specifies spacing between bars in a cluster. -25 leaves a space 
between bars 25% of one bar's width. 


Fill 


Specifies how to fill the bars. 


Solid Fills each bar in a solid color. 
Patterns Fills each bar in a pattern. 


Individual series colors and patterns are set using //Grapbics, Data. 
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Chart Options Menu for Pie Charts 


DATA SOURCE 
Pie mode 
Series/Point H 


3D 

FILL 

SORT SEGMENTS 
START ANGLE 


EXPLOSION 
Type 
Lov Value 
High Value 


SEGMENT LABELS 
Display 
Parentheses 
Placenent Outs ide 


Data Source 


Pie mode Lets you choose how a Pie chart is plotted by 
Series or by PointsSlice. 


x Series — Plots all points of a single 
series. 
3 PointSlice — Plots a single point of all 
series. 
Series/ Specifies which series is plotted, or which 
Point # point of each series is plotted. The value is 


based on the Pie mode selection. 


For example, if series 1 is specified, all points 
in the first series are plotted as segments. If 
point 1 is specified, then the first point of 
each series is plotted as a segment. 
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CERNS nll 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


3D 

Fill 

Sort Segments 

Specifies how the segments are displayed. 


Yes Sorts the segments in the order of their sizes, 
from smallest to largest. 


No Charts the segments in the order they appear 
in the Chart Data and Options Menu. 


Start Angle 


Specifies from which angle the Pie chart is drawn. You can 
specify a Start Angle from 0 degrees to 360 degrees. 
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For example, the following two Pie charts are exactly the same, 
except the first began at an angle of 0 degrees, and the second 
began at an angle of 270 degrees. 
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Explosion 


Separates (explodes) one or more segments of the pie. 


Type- Specifies the segment or segments to be 
exploded. 


w None — Does not explode any 
segments. 


# All — Explodes all segments. 


m Below — Explodes all values below 
and including the Low Value. 


a Above — Explodes all values above 
and including the High Value. 


a Within — Explodes all values between 
and including the Low and High 
Values. 


a Outside — Explodes all values outside 
and excluding the Low and High 
Values. 


a Smallest — Explodes only the smallest 
value. 


a Largest — Explodes only the largest 
value. 


za List — Explodes the points or series 
specified to be exploded in the Chart 
Data and Options Menu 
(//Graphics, Data). 


Low Value Lets you specify a low value for determining 
which segments to explode. 


High Value Lets you specify a high value for determining 
which segments to explode. 
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Segment Labels 
Specifies the type of label for each segment of the pie. 
Display Specifies how to display pie segment labels. 
& None — Does not display labels. 
= Data Labels — Displays the data labels 
specified in the Data Label Definition 
and Options Menu, for each segment. 
E Percent — Displays a percent label for 
each segment, which represents that 


segment's percentage of the pie. 


la Both — Displays both the data labels 
and percent labels. 


Parentheses Specifies whether the segment labels are 
enclosed in parentheses. 


E Yes — Encloses the segment labels in 
parentheses. 
@ No — Does not enclose the segment 


labels in parentheses. 
Placement Specifies where the segment labels are placed. 


w Inside — Places the segment labels 
inside each segment. 


= Outside — Places the segment labels 
outside each segment. 


Chart Options Menu for Dual Charts 


Specifies the attribute options for Dual charts. The top of the 
menu is divided into Left and Right chart, where you define the 
chart type variation and the series number to be charted. The rest 
of the chart contains options that affect both charts. 
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These charts need not relate to each other. 


pee CHARY OPTIONS WEN” 


LEFT CHART _ RIGHT CHART 
Type Type 
Series Series 


3D 

FILL 

SORT SEGMENTS 
PROPORTIONAL 
LINK CHARTS 


EXPLOSION 
Type 
Lou Value 
High Value 


SEGMENT LABELS 
Display 
Parenthesis No 
Placenent Outside 


Left Chart and Right Chart 


Lets you specify the type of each chart and the series to be 
plotted for each chart. 


Type Specifies the chart type: Pie or Bar. 

z Pie — Presents data as a Pie chart. 

a Bar — Presents data as a Bar chart. 
Series Specifies the series to be plotted. Generally, 


you'll use series 1 for the left chart and 2 for 
the right. You can enter a series number from 
1 to 10. 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


3D 
Fill 
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Sort Segments 
See Chart Options Menu for Pie Charts for the choices. 


Proportional 


For Pie-Pie charts only, specifies whether the two charts are 
proportionally sized — the areas are proportional to the totals of 
the series. 


Yes Displays the charts as proportionally sized. 

No Does not display the charts as proportionally 
sized. 

Link Charts 


Specifies whether a link is displayed between the two charts; 
usually between two related charts. The first exploded segment 
of the left chart (or first point or series in the range if no 
explosion is specified) is centered on zero degrees, and a dashed 
line links that segment to the right chart. If the left chart is a bar, 
the first point that would be selected by the above rule is linked 
to the right chart. 


The link is useful for linking an exploded segment in the left chart 
to the whole Bar or Pie right chart to show the breakdown of the 
exploded segment. 


Yes Displays a link between the two charts. 
No Does not display a link. 


For choices of the following options, see Chart Options Menu for 
Pie Charts: 


Explosion 

Low Value 
High Value 
Segment Labels 
Parentheses 
Placement 


2-282 SuperCalc Reference Manual 


//Graphics 


A A ee eee 


Chart Options Menu for Line Charts 


Specifies the attribute options for Line charts. 


4 : 5 


LINE OPTIONS 
Fit Type Connect § Connect Connect 
Line Style i i = Solid — Solid Solid 
Line Width : ‘Thin ‘Thin ‘Thin 
Marker Type i |  DownTri Pound 

5 _— 


Marker Size : O 


TYPE 


DRAW 
HORIZONTAL 
3D 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Fit Type 
Line Style 
Line Width 
Marker Type 
Marker Size 


Type 


Specifies a variation of a Line chart type. 


Simple-Line Presents data as a Line chart. The number of 
lines is equal to the number of series defined. 


Stacked-Line Accumulates all the series for each period 
(series 1 + series 2 +...+ series 10) in a single 
stacked line. The number of lines is equal to 
the number of series defined, and the number 
of symbols for each line is equal to the 
number of data points in each series. 
Negative values are considered to be zero. 
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Draw 
Specifies whether the data points will be connected with lines, 


marked with markers, both, or none. 


None Does not display lines or markers. Only 
displays the data point labels. 


Lines Connects data points with lines. 
Markers Displays markers for each data point. 
Both Displays both the lines and the markers. 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Horizontal 
3D 
Chart Options Menu for Area Charts 


Specifies the attribute options for Area charts. 


TYPE 


HORIZONTAL 


Type 
Specifies the variation Area chart type. 
Simple-Area Presents data as a filled-in Line chart, where 


the number of areas is equal to the number of 
series defined. 
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Stacked-Area Presents data as a filled-in Stacked-Line chart. 
All the series are accumulated for each period. 
The number of areas is equal to the number 
of series defined. Negative values are 
considered to be zero. 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Horizontal 
3D 
Fill 


Chart Options Menu for Hi-Lo Charts 


Specifies the attribute options for Hi-Lo charts. 


LINE OPTIONS : | 
Fit Type i Comect Connect Comect  Comect 
Line Style Solid Solid | Solid Solid 
Line Width | Thin | Thin Thin Thin 
Marker Type Box ae: | DownTri Pound 

; A os 


Marker Size 5 | 5 | § 


MARKERS 
TREND LINES 
HORIZONTAL 


For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Fit Type 
Line Style 
Line Width 
Marker Type 
Marker Size 
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Markers Specifies whether to display markers for each 
data point. 
se Yes — Displays markers for each data 
point. 
a No — Does not display markers. 
Trend Lines 


Specifies whether to display trend lines. 


Yes Displays trend lines. 
No Does not display trend lines. 
Horizontal 


See Chart Options Menu for Bar Charts for the description and 
choices. 


Chart Options Menu for X-Y Charts 


Specifies the attribute options for X-Y charts. 


5 


LINE OPTIONS 
Fit Type L Connect Connect 
Line Style : Solid Solid 
Line Width - Thin i Thin 
Marker Type x Pound 


Marker Size 5 5 E 5 


TYPE 
DRAW 
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For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Fit Type 
Line Style 
Line Width 
Marker Type 
Marker Size 


TYPE 


Specifies the variation X-Y chart type. 


XYY Plots series 2 through n (as Y series) against 
series 1 (as an X series). 


XYXY Plots pairs of series against each other. Odd 
numbered series are X, even numbered series 
are Y. If you have an odd number of series, 
the last one is ignored. 


Draw 


See Chart Options Menu for Line Charts for the choices. 


Chart Options Menu for Radar Charts 


Specifies the attribute options for Radar charts. 


4 os 


LINE OPTIONS 
Fit Type Connect Connect Comect Connect | Connect 
Line Style i Solid | Solid Solid © Solid 
Tine Width i Thin Thin Thin | Thin 
darker Type : Box O DounTri Pound 
Marker Size 5 A 5 o 5 


TYPE 
DRAW 
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For choices of the following options, see Chart Options Menu for 
Bar Charts: 


Line Style 

Line Width 

Marker Type mee 
Marker Size 

TYPE 

Specifies the variation Radar chart type. 


XYY Plots series 1 as the angle against all other 
series as the radiuses. 


XYXY Plots pairs of series against each other where 
the first series is the angle and the second is 
the radius. If you have an odd number of 
series, the last one is ignored. 


Draw 


See Chart Options Menu for Line Charts for the choices. 


//Graphics,Global 


Lets you specify chart-related device settings. When you enter 
//Graphics, Global, the menu line displays these options: Quit, 
Drivers, Options. 


//Graphics,Global,Quit 


Returns you to the //Grapbics menu. 


//Graphics,Global,Drivers 


Specifies settings for plotting hardcopies, or writing charts to other 
graphics-formatted files. Once one of these options is selected, 

every time you plot with //Grapbics, Plot or Alt-F10, all charts are “ras 
sent to the device or file specified. 
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When you enter //Grapbics, Global, Drivers, the menu line displays 
these options: Normal, PIC-file, CGI. 


Normal 
Sends charts to the device (printer or plotter) selected in 


/Global, Grapbics, Device. This is the default. 


PIC-file 


Writes charts to a PIC (Lotus graphics format) file. You're 
prompted for a filename. The extension (.pic) is added by default 
unless you specify an extension. 


CGI 


Sends charts to CGI (Computer Graphics Interface) devices or 
files. The CGI options use drivers that must be pre-installed in 
the CONFIG.sys file. See Appendix K for more information on 
CGI drivers. You are given the following options on the menu 
line: Display, Slide, Printer, Plotter, Camera, Metafile. 


Display Lets you specify an available high-resolution 
screen display to view your charts. 


Slide Writes a chart to a file for subsequent 
production of a high-quality slide or other 
format graphic. To use this slide service, you 
must open an account with the Computer 
Associates Graphics Service. See the insert in 
your SuperCalc package for further 
information. 


You're prompted for a filename. The 
extension (.slv) is added by default unless you 
specify one. 


Printer Lets you specify a CGI printer. 


Plotter Lets you specify a CGI plotter. 
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Camera Lets you specify a camera-ready slide service 
device. 
Metafile Writes charts to a CGM (Computer Graphics 


Metafile) file format. You’re prompted for a 
filename. The extension (.cgm) is added by 
default unless you specify one. 


//Graphics,Global,Options 


Displays the Global Options Menu, which contains monitor and 
printing settings. Options available depend on your computer, 
color adapter card, and monitor. 


Monitor Type 


Specifies the type of monitor. 


Default Lets SuperCalc set the monitor type according 
to the type of monitor you’re using, or you 
have specified in 
/Global, Optimum, Next, Attribute. 


Color Sets a color monitor type. Use if you wish to 
override a /Global, Optimum, Next, Attribute 
setting of Black/White, and use color for 
graphics only. 


Monochrome Sets a black and white monitor type. Use if 
you wish to force your graphics to use gray- 
scale renderings although your monitor (and 
spreadsheet display) is color. 


Monitor Resolution 


Lets you specify the best monitor resolution for your monitor. If 
you have more than one option, lower resolution offers more 
colors, and higher resolution offers fewer colors. 


Low Specifies low resolution. Use for EGA and 
VGA monitors. 
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Medium Specifies medium resolution. Use for EGA 
monitors only. 


High Specifies high resolution. Use for CGA, EGA, 


and VGA monitors. 


Printer Resolution 


Lets you specify the printer resolution for your hardcopies. The 
higher the resolution, the slower the print speed. Resolution 
alters the number of dots per inch. 


Single Specifies the lowest resolution, which prints 
the least number of dots per inch, but at the 
fastest speed. 


Double Prints twice as many dots per inch as Single. 

Triple Prints three times as many dots per inch as 
Single. 

Quad Specifies the highest resolution, which prints 


the highest number of dots per inch (four 
times Single), but at the lowest speed. 


Prompt for Pen Change 


Specifies whether you'll be prompted to change pens when 
plotting charts with more colors specified than the plotter has 
pens. 


Yes Prompts for pen change. 


No Does not prompt for pen change. This option 


is useful when running macros that plot. 
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Page Eject 


Specifies whether the paper is ejected after plotting a chart, or if 
more than one chart is plotted per page. 


Yes Ejects the paper after plotting a chart. 

No Holds the paper so more than one chart plots 
on a page. 

ViewGraph 


Specifies whether to use an overhead layout for viewing and 
plotting. This layout is used for transparencies. 


Yes Plots charts for overhead transparencies. 
No Does not use overhead layout. 
//Graphics,Name 


Saves newly created charts or lets you edit existing charts. When 
you select Name, the menu line displays these options: Retrieve, 
Store, Delete, Zap. 


All operations in //Graphics work on the current chart. The 
current chart and all the charts you have named with 

//Grapbics, Name will be saved to disk when the spreadsheet is 
saved using /Save. A spreadsheet can have an unlimited number 
of named charts. 


//Graphics,Name,Retrieve 


Loads a chart descriptor that has been previously saved with a 
Store. When you choose Retrieve, you are prompted for a chart 
name to load. Enter the name and press Return or press F3 to 
select from a list of existing charts and press Return. 


The chart descriptor you retrieve will replace your current chart. 
The data in your spreadsheet will remain untouched. 
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//Graphics,Name,Store 


Stores the current chart descriptor. When you choose Store, you 
are prompted for a chart name to use when the chart is saved. 
Enter the name and press Return. 


The current chart can now be modified or zapped without 
affecting the Stored chart. 


Compatibility with Previous SuperCalc Versions 


You can use numbers as well as names, but do 
not use numbers one one through nine. When 
you load chart descriptors from previous 
SuperCalc versions, they are loaded as numbers, 
one through nine. These charts will overwrite 
any existing //Graphics charts named with these 
numbers. Also, if you use the hidden graphics 
command /View to create a chart, that chart 
number will also overwrite an existing //Graphics 
chart with the same numbered name. 


//Graphics,Name,Delete 


Deletes a named chart descriptor. When you choose Delete, you 


are prompted for a chart name. Enter the name and press Return 


or press F3 to select from a list of named charts and press 
Return. The chart descriptor you select will be deleted. 


The current chart is not affected by the delete. To clear the 
current chart, use //Graphics, Zap. 


//Graphics,Name,Zap 


Deletes all named charts. 


The current chart is not affected. After Zap, it is the only chart 
available. 
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//Graphics,Plot 


Plots the current chart on the printer or plotter specified with 
/Global, Graphics, Device. You can also press Alt-F10. When the 
chart is plotted, you are returned to the place the program was 
before plotting. 


Plotter output requires a different set of attributes from the printer 
and screen output. To help you get started with setting the 
attributes for a plotter, SuperCalc supplies a PLOTTER.cfg 
configuration file, which contains default plotter attributes. A 
SCREEN.cfg configuration file is also supplied, which contains 
default printer and screen attributes. The SCREEN.cfg file contains 
the original SuperCale //Graphics defaults. 


To load the PLOTTER.cfg configuration file, enter: 
/Global,Keep,From,PLOTTER.cfg,Graphics,All 


To restore the printing and viewing defaults, load the SCREEN.cfg 
configuration file or your own defaults in the same manner. 


//Graphics,Zap 


Zap erases the current chart from memory. To remove a chart 
from the Chart List, use //Graphics, Name, Delete. To delete all 
named charts, use //Graphics, Name, Zap. 


No Cancels the command and returns to the 
chart. 
Yes Erases the current chart from memory, 


restoring all defaults. 


//Graphics,Quit 


Quit exits the //Graphics menu and returns to the spreadsheet. 
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//Graphics 


SuperCalc supports 71 colors. The first 15 colors are the colors 
used in previous versions of SuperCalc. These colors are 

numbered within the Select window to distinguish them from the 
other colors. The colors are: 


None 

1Blue 
2Green 
3Cyan 

4Red 
SMagenta 
6Brown 
7White 
8Grey 
OLtBlue 

10 10LtGreen 
11 11LtCyan 
12 12LtRed 

13 13LtMagenta 
14 14Yellow 
15 15HiWhite 
16 Avocado 

17 Beige 

18 Black 

19 Blue 

20 BlueGreen 
21 BluePurple 
22 BluishGreen 
23 BluishPurple 
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24 Brick 

25 Brown 

26 Burgundy 

27 Charcoal 

28 Chestnut 

29 Coral 

30 Cream 

31 Cyan 

32 Evergreen 

33 Gold 

34 Gray 

35 Green 

36 GreenishBlue 
37 GreenishYellow 
38 Kelly 

39 Khaki 

40 Lavender 

41 Magenta 

42 Mustard 

43 Navy 

44 Ochre 

45 Olive 

46 Orange 

47 OrangeYellow 


48 OrangishRed 
49 OrangishYellow 
50 Peach 

51 Pink 

52 Purple 

53 PurpleRed 

54 PurplishBlue 

55 PurplishRed 

56 Red 

57 ReddishOrange 
58 ReddishPurple 
59 RedOrange 

60 Rose 

61 Rust 

62 Sky 

63 Tan 

64 Tangerine 

65 Turquoise 

66 Violet 

67 White 

68 Yellow 

69 YellowGreen 
70 YellowishGreen 
71 YellowishOrange 
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//Import loads files created by other programs, including 


spreadsheet and database programs, so they can be used by 
SuperCalc. 


//Import, - XDIF, filename, - Replace {Modification? No/Yes} 
All 
Values 
Consolidate 


Part, from range,to range i 
- = all 
Values 
+ 


* 


/ 
DIE filename, poezy Replace {Modification? No/Yes} 
Rowwise All 


Consolidate 


Part, from range,to ds 
Values 
9 
+ 


* 


/ 
CSV, filename, —Replace {Modification? No/Yes} 
All 


Consolidate 


Part, from range,to range C 
Values 
> 
+ 


* 


/ 
Numbers, filename, - Replace {Modification? No/Yes} 
- All 
Part, from range,to range 
Text, filename, : Replace {Modification? No/Yes} 


All 
Part, from range,to range 
Replace {Modification? No/Yes} 
All 
Part, from range,to range 
dBase, filename, Replace {Modification? No/Yes} 
All 
Extract 
Names 


VisiCalc, filename, 
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//Import converts data files created by other programs into 
SuperCalc’s file format, and loads them into the current 
spreadsheet. The command converts as much data as possible 
into its SuperCalc counterpart. 


After selecting //Import, specify the file format you're importing 
and the name of the foreign file. SuperCalc supplies the 
appropriate extension for each file format. 


Once you've specified the filename, some additional options are 
offered, including All, Values, Consolidate, Replace, Part. Not all 
options are available for each file format. See Import Options later 
in this chapter for full descriptions. 


//Import,XDIF 


Converts an XDIF file into SuperCalc format, including formulas 
and display formats. Available options: Replace, All, Values, 
Consolidate, Part. 


//Import,DIF 


Converts a standard DIF file into SuperCalc spreadsheet format. 
Select either Colwise or Rowwise import: 


Colwise Each record becomes a column. 
Rowwise Each record becomes a row. 


Available options: Replace, All, Consolidate, Part. 


//Import,CSV 


Converts a Comma Separated Values (CSV) file into SuperCalc 
format. 


You can import formulas by enclosing them in backslash 
characters. Thus, you can create CSV files (for example, with a 
BASIC program) that contain formulas for SuperCalc. For 
example, isum(a1:a20)1 becomes SUM(A1:A20). 
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Available options: Replace, All, Consolidate, Part. 


//import,Numbers 


Converts a numeric file into SuperCalc format. Numbers imports 
only numbers and text enclosed in double quotes, one line per 
row. Each item (number or quoted text) is put into a separate 
cell on the current row. Entries are truncated to 240 characters. 


Available options: Replace, All, Part. 


//Import,Text 


Imports an ASCII file as text, one line per cell. Lines are 
truncated to 240 characters. See //Data,Parse in this chapter for 
ways to parse imported data into individual database fields. 


Available options: Replace, All, Part. 


/ Import, VisiCalc 


Converts VisiCalc data files into the SuperCalc spreadsheet format. 
All formulas and values are converted with these exceptions: 


m Both the @AND and @OR functions in VisiCalc allow any 
number of arguments while the same functions in SuperCalc 
take only two arguments. In order to retain the accuracy of 
these functions, nested AND or OR functions are generated 
during conversion. If the converted formula exceeds 240 
characters in length, a warning displays on your monitor. 


= Boolean formulas that evaluate TRUE or FALSE in VisiCalc 
result in 1 or 0 in SuperCalc. 


m The formula prefix “+” in VisiCalc is removed when converted 
to SuperCalc. For example the VisiCalc formula +A1+B1 is 
converted to the SuperCalc formula A1+B1. 


eee” 
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m VisiCalc displays 21 rows per screen while SuperCalc displays 
20 rows per screen. If a worksheet was saved with the cursor 
at the 21st row of a screen in VisiCalc, then converted to a 
SuperCalc worksheet, the cursor stays in the same cell with 
the screen scrolling up one row, i.e., the first row scrolls off 
the top of the screen. Whenever there is a conflict between 
retaining original screen and original cursor position, the 
original cursor position prevails. 


= Window split with title lock is handled differently by 
SuperCalc and VisiCalc. VisiCalc always carries the title lock 
in the second window. SuperCalc does not carry the title lock 
in the second window. The conversion, however, retains the 
lock in both windows as if the user also set the title lock in 
the second window. 


m Repeated text in VisiCalc repeats across the column width 
only. When converted to SuperCalc, VisiCalc repeated text 
expands across the row to a non-empty cell, as SuperCalc’s 
repeating text does. 


Available options: Replace, All, Part. 


//Import,dBase 


Converts dBase III database files into SuperCalc spreadsheet files. 
True/False operators are converted to 1 and 0. Memo fields are 
not converted. 


//Import,dBase has two additional commands: Names, Extract. 
Before either option can be used, you must specify three data 
ranges by selecting the appropriate //Data options: Input, 
Criterion, and Output. See //Data, earlier in this chapter, for a 
full description of the data ranges. During dBase III imports, 
SuperCalc uses the three data ranges in this order: 


1. Each dBase record comes into the input range, which must be 
at least two rows deep. 


2. Each record is evaluated against selection criteria, if any, 
entered into the criterion range. 
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3. If the record meets the selection criteria and is accepted, it is 
added to the output range. The output range must be deep 
enough to hold the incoming records. 


The first row of each data range is reserved for field names, 
imported with //Import, dBase, Names or entered manually. — 


//Import,dBase,Names 


Reads dBase III field names from the dBase file into the SuperCalc 
criterion range. Then you can copy them into the first row of the 
input and output ranges, repositioning them if you want. 


The order of field names in the Output range determines the 
order of the fields imported into that range. If field names are 
deleted from either the input or output range, that field will be 
omitted from the record. New field names not included in the 
dBase records may be added at any position in an Output range. 
These fields will remain blank until filled by other means such as 
direct entry, copying, importing another file, or creating formula 
links to other spreadsheets. 


Once the names have been imported into the criterion range, you 
can enter selection criteria to determine which dBase records will 
be imported. Chapter 1 of the User’s Guide contains detailed 
instructions for entered selection criteria. 


When selection criteria are in place and you have entered field 
names in the first row of the input and output ranges, use 
//Import,dBase, Extract to import the file. 


//Import,dBase,Extract 


Reads dBase records into the input range, compares them with 
the selection criteria, and adds accepted records to the output 
range in the order of the field names entered there. This 
procedure is comparable to /Data, Extract. All Data Management 
Input, Output, and Criterion rules apply; for more information see 
//Data, earlier in this chapter. — 


Other available options: Replace, All. 
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//Import Options 


Depending on the file format you're importing, the following 
options are available: 


//Import,Replace 


Clears the existing SuperCalc spreadsheet from memory and then 
imports all data from the selected file. The effect is the same as 
entering /Zap, Yes followed by //Import, All. If the current 
spreadsheet has been edited, the program asks for confirmation 
before zapping it. If supporting spreadsheets are autoloaded, you 
can select No to cancel Replace and save them individually. 
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//Import,All 


Imports the entire data file into SuperCalc format including values, 
formulas, and display formats wherever possible. The import 
starts in cell A1. 


//Import, Values 


Imports the entire data file into SuperCalc format, including only 
the calculated values of formulas, not the formulas. Display 
formats are imported when possible. 


//Import,Consolidate 


Combines the corresponding cells of the disk file and the current 
spreadsheet and places the result into the spreadsheet using the 
rules for “consolidation addition.” See /Load, earlier in this 
chapter, for a complete discussion of consolidation arithmetic. 


//Import,Part 


Lets you specify which part of the foreign data file you want to 
import into SuperCalc. You specify a from range in the foreign 
spreadsheet and a to range in the SuperCalc spreadsheet. The from 
range corresponds to columns and rows on a printed version of the 
foreign data file. Some file formats allow only row entry. Type a 
comma (,) after the from range to display a list of //Import, Part 
options. Options +, -, *, and / follow SuperCalc's rules for consoli- 
dation arithmetic. 
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If you want to use consolidation arithmetic options on the entire 
spreadsheet, select //Import, Part, then enter ALL as the from 
range, Al as the to range, and use +, -, *, or / as described in the 
following sections. For more information on consolidation 
arithmetic, see /Load, earlier in this chapter. 


//Import, Part, All 


Imports the selected part of the foreign file, including formulas 
and display formats when possible. 


//Import, Part, Values 


Imports the selected part of the foreign file, including display 
formats when possible. Formulas are not imported, only their 
calculated values. | 


//Import, Part, + 


Imports the selected part of the foreign file and adds its cell 
values to cells of the existing spreadsheet following the rules for 
consolidation arithmetic discussed under /Load. 


//Import, Part, - 


Imports the selected part of the foreign file and subtracts its cell 
values from those of the existing spreadsheet following the rules 
for consolidation arithmetic (see /Load). 


//Import, Part, * 


Imports the selected part of the foreign file and multiplies its cell 
values by those of the existing spreadsheet following the rules for 
consolidation arithmetic (see /Load). 


//Import,Part,/ 


Imports the selected part of the foreign file and divides its cell 
values into those of the existing spreadsheet following the rules 
for consolidation arithmetic (see /Load). 
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Parsing Imported Files 


When you import Text, data comes in as single-column strings — 
one string in each row. 


SuperCalc’s //Data, Parse command can separate these strings into 
fields, one field per column. The parsing procedure lets you 
assign data types to each field — text, values, dates, and times. 
Then, you can perform Data Management operations on the data, 
just as if you had entered it directly. For instructions, see //Data, 
earlier in this chapter. 
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//Macro 


//Macro performs a variety of macro-related tasks that let you 
build, save, run, debug and analyze macros, as well as convert 
Lotus 1-2-3 macros to the SuperCalc macro format. For detailed 
descriptions of the macro syntax and commands, and sample 
macros, see Chapter 4 in this manual. 


//Macro, > Learn,range 
Read, filename,range, All 
Macros-only 
Labels-macros 
Comments-macros 
If name found: 


Write, filename |, - Backup , range, - All 
- Change Macros-only 
Overwrite Labels-macros 


Comments-macros 
eXecute, filename 
Analyze, Go 
Range,range 
Type, Contents,(Yes/No) 
- Transfers,(To/From/Both/None) 
Modifies ,(Affects/Changed by/Both/None) 


Output, Printer 
File, filename , Backup 
Change 
Overwrite 
Console 
Quit 
Breakpoint, ners Location, ES corer 
Zap File, filename,record 
Condition,cell 
Zap 
Convert, SC E ; Le 
1-2-3 Range, range 
Trace, Console 
L- Printer 
File, Open, filename |, - Backup 
- Change 
Overwrite 


Close, filename 
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SuperCalc uses function keys to ease the process of building and 
debugging macros. Each process is done in a different macro 
mode, which, when invoked, is indicated on the right half of the 
help line. The macro modes are: MACRO, LEARN, DIRECT, 
STEP, and ASTEP. 


The following table shows the macro function keys, the mode 
they invoke (if any), and their functional descriptions. These 
modes are described later on in this section. 
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Key Mode Description 


Alt-F2 STEP Toggles STEP mode 
on/off. STEP mode 
lets you control 
execution of each 
macro command by 
pressing F8 to 
execute each 
command. 


Alt-F3 Displays the Macro 
Name/Range 
Directory. Macros are 
listed by spreadsheet. 
You can use a bar 
cursor to select the 
macro to execute. 


Alt-F4 LEARN Toggles LEARN mode 
on/off. LEARN mode 
records every 
keystroke you make 
and writes it to a 
macro Learn range in 
the spreadsheet. You 
define the Learn 
range with 
//Macro,Learn before 
invoking LEARN 
mode. 


Alt—F5 Executes the 
spreadsheet macro 


specified (or use 
Alt-=). 
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Alt—F6 DIRECT 
Alt-F8 ASTEP 
Alt—x 
F8 

MACRO 
//Macro,Learn 


Toggles DIRECT 

mode on/off. 

DIRECT mode lets 

you enter 

programming macro 

commands during 

LEARN mode. — 


Toggles AUTOSTEP 
mode on/off after 
turning on STEP 
mode with Alt—F2. 
AUTOSTEP mode 
automatically displays 
the macro lines 
without pressing F8. 


Executes a 
spreadsheet macro 
named \x or a file 
named X.xqt (where 
x is any letter, a toz). 


Single steps the given 
character position 
within the specified UA 
cell in STEP mode. 
Resumes macro 
execution. 


Indicates you are 
currently processing a 
macro. 


Lets you use LEARN mode, which captures your keystrokes into a 
spreadsheet macro. To use LEARN mode, you first establish a 
Learn range with //Macro, Learn,range. You must specify a 
column range large enough to contain the entire macro. When 
LEARN reaches the bottom of the Learn range, you are 


automatically bumped out of LEARN mode. 


After defining the Learn range, you press Alt-F4 to toggle LEARN 


mode on. While in LEARN mode, all your keystrokes are 


recorded within the Learn range. 
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The learned keystrokes are appended to the end of the last 
text cell within the learn range. 


If the Learn range contains blank cells, those cells are jumped 
over. Thus, if you have more than one macro in the learn 
range, LEARN appends to the last macro in that range. 


Learned slash command keystrokes are entered as the exact 
characters you type. For example: 


/Format,Column,C:F,5 Return 


is entered as 


/FCC:F,5~ 
where the tilde (~) represents Return. 
Alphanumeric keys are entered directly. 


Other keys, such as cursor movement and function keys, are 
entered as their corresponding macro commands enclosed in 
braces, such as {TAB}. 


Consecutive macro commands that can take numeric 
arguments are automatically compressed. For example, four 
sequential Down Arrows are compressed into {DN 4}. 


You can manually enter keystrokes or commands directly into 
the macro, using DIRECT mode within LEARN. Press Alt—F6 
to toggle DIRECT mode on, which lets you enter text on the 
entry line. A Return enters those keystrokes directly into the 
next macro cell. 


When using multiple spreadsheets, LEARN mode uses only one 
Learn range. For example, if you activate LEARN mode and 
select a Learn range in TEMP1, then change to TEMP2, macro 
recording will continue in TEMP1. The fact that you changed 
spreadsheets is recorded there. Pressing Alt—F4 again turns off 
LEARN mode and completes recording to the Learn range in 
TEMEL 
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Caution When Using /Zap 
or //Spreadsheets,Zap 


Enter /Zap, Yes or //Spreadsheets,Zap,Yes into a 
macro only while in DIRECT mode. Entering the 
command while in LEARN mode clears the 
present spreadsheet, including the macro that 
was in the process of being created. 


//Macro,Read 


Reads a file macro (created with //Macro, Write) into the 
spreadsheet range you specify. You're given a choice of four 
ways to read in the macro: All, Macros-only, Labels-macros, or 
Comments-macros. These are defined later in this chapter. 


When you enter an unqualified filename (such as TEST or 
TEST.xqt without the full pathname) to be read, SuperCalc 
looks for the file in the following order: 


1. Default directory 
2. Spreadsheet paths set up with //File, Path 
3. Global paths set up with /File, Path 


If you specify a single cell, the entire macro is read, 
overwriting existing unprotected cells, and terminating at the 
bottom of the column. 


If you specify a partial column, Read terminates at the end of 
that partial column, truncating the macro if it is longer than 
the specified range. Exception: If any part of a menu is 
within the range, the entire menu is fully read. 


kead stops at protected cells. 
When reading in a file macro with labels (you select Al or 


Labels-macros options), you must leave an open column to 
the left of the macro range. 
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//Macro,Write 


Saves a spreadsheet macro to a file macro. You're given a choice 


of four ways to write the macro: All, Macros-only, Labels-macros, 
or Comment-macros. These options are defined later in this 
chapter. 


A file macro name must be any valid DOS filename string 
from one to eight characters. SuperCalc appends a .xqt 
extension automatically if no other extension is specified with 
the //Macro, Write command. 


If you specify an alternate extension, you must include that 
extension when reading or executing the macro. 


To save the entire macro, you specify only the single cell that 
contains the top macro statement if the macro is continuous 
with no blank cells. Otherwise, you must specify the entire 
range. 


Write terminates at the end of the macro which is determined 
by a nontext cell or the bottom of the spreadsheet. 


If you specify a partial column, only those cells within the 
partial column are saved; even if the column is only part of a 
macro or contains multiple macros. In this case, SuperCalc 
does not stop on blank cells. 


A file macro is nothing more than a macro range that is saved 
on disk in ASCII format. You first build the macro within a 
spreadsheet, then use //Macro, Write... to save the macro as a 
file macro. 


You can create a file macro with a word processor that writes 
in standard ASCII format. The file macro (eXecute file) must 
be exactly as it would have been if you had used SuperCalc, 
except the first statement must be {MACRO}. (//Macro, Write 
does this for you automatically.) See the (MENU) command 
in Chapter 4 for an example of a file macro written with a 
word processor. 
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SuperCalc recognizes a file macro by the first statement, 
{MACRO}, not by the .xqí extension. 


When you Read and Write file macros, the following options are 


available: 

All Means read/write all three columns, Labels (to 
the left), Macros, and Comments (to the right). 
All three columns must be continuous. 

Macros-only Means read/write only the Macro statements: 
Labels and Comments are ignored. 

Labels- Means read/write only Labels and Macros; 

macros Comments are ignored. 

Comment- Means read/write only Macro statements and 

macros Comments; Labels are ignored. 

//Macro,eXecute 


Lets you invoke a file macro from any spreadsheet. You can 
activate a macro (eXecute) file in three ways: 


1. 


Enter //Macro,X (eXecute) on the entry line, and then 
specify the filename for the file macro. The extension .xqt is 
assumed, but you may specify any valid extension. 


When you enter an unqualified filename (such as TEST or 
TEST.xqt without the full pathname) to be invoked, SuperCalc 
looks for the file first in the default directory, then in the 
spreadsheet paths set up with //File, Path, and finally in the 
global paths set up with //File, Path. 


Specify a file macro name directly when you load SuperCalc 
from your operating system. For example, to execute a file 
named SAMPLE.xqt from Drive B, you would enter the 
following at your system prompt: 


SC5 B:SAMPLE 
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3. Use the Alt key with a one-letter file macro name to execute 
the macro directly from the spreadsheet or disk. For 
example, Alt-C executes the file named C.xqt. 


SuperCalc first looks for the named range \C within all 
spreadsheets in memory (in load order), before checking for a 
file macro on disk. If that name exists, SuperCalc will execute 
it in place of the file macro. 


//Macro,Trace 


Controls STEP or AUTOSTEP tracing of a macro execution on 
screen (console), or outputs each step of a macro execution to a 
file or printer. Both modes let you review the effect of each 
statement in the macro, one step at a time, on the help line. 


m All three Trace options (Console, Printer, File) are activated 
by Alt-F2. To create a trace output for a macro within the 
current spreadsheet: 


1. Select //Macro, Trace, and select the output option. 
Console is the default. | 


2. Press Alt-F2, which toggles STEP mode on and off, 
allowing you to manually follow the process of the macro 
during execution. 


3. Invoke the macro by pressing Alt-F5 and entering the 
macro name or cell address. 


4. Press F8 to execute each successive macro statement. 


m Alt—F8 toggles AUTOSTEP mode on and off from STEP mode. 
AUTOSTEP mode automatically advances the Trace display 
every 1/4 second (no need to press F8). The speed can be 
adjusted by pressing Alt+ (faster) and Alt- (slower). You 
must use the gray + and - keys to the right of the number 
keypad. 
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m The last selected Trace command remains as the current 
output mode until another is chosen. For example, if you 
had selected Printer, when you run STEP mode, the 
information would continue to be sent to the printer. You 
must select Console to print out the information only on the 
screen. 


m You can see the macro being executed on the last line in the 
dialog panel. It tells you the mode, macro level, macro label 
Gf any), cell address (or in a file macro, line number), and 
cell contents (macro statements). 


As the cursor steps through each statement, the macro level, 
label, and cell address are updated accordingly. If the macro 
cell contents are too long to fit on one line, the contents are 
scrolled to the left. 


Macro level indicates the hierarchical structure of the macros. 
The originally executed macro is level 1; any macros that are 
called or branched to by level 1 are level 2 macros, level 3 

macros, etc. There is no limit to the number of macro levels. 


m Since the Trace macro information covers the help line, you 
can't see the macro prompts, help messages, or indicators 
while running in STEP or AUTOSTEP mode. Alt-Spacebar 
acts as a toggle to restore these messages and other help line 
information. When pressed again, the Trace information 
reappears. 


If you press Alt-Spacebar while running in AUTOSTEP 
mode, the macro continues to execute commands. If the 
macro displays a message on the help line, you’ll want to 
toggle the help line to see the message. 


//Macro,Trace,Console 


Displays Trace output line by line, on the screen only. 
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//Macro,Trace,Printer 
Directs Trace output to a printer as well as on the screen. 


m The printed width is governed by the page width setting on 
the Output Options Menu. 


= Output continues until the macro ends, or until you enter 
CtriBBreak or Alt-F2. Pressing Alt-F2 again restarts printing 
where it left off. 


so 

3 
= 
Š 
0 


//Macro,Trace,File 


Builds an ASCII text file of the Trace output and also displays the 
output on the screen. 


Open Lets you create a .prn file (the default 
extension), or reopen an existing one. The 
file remains open for additional output until 
you select //Macro, Trace, File, Close or the 
Printer or Console options. 


Close Closes the opened file. File output terminates 
under the same conditions as printed output. 


//Macro,Breakpoint 


Lets you place up to eight different breakpoints at strategic places 
in the macro, to help you narrow down possible problems. 
When you run the macro and it reaches a breakpoint, macro 
execution goes into STEP mode. Then you can carefully watch 
each macro statement as it is executed. The {STEP} macro 
command ends STEP mode and resumes macro execution when 
encountered within the macro. 


//Macro,Breakpoint,1-8 


Specifies the breakpoint number. You can have up to eight 
breakpoints for a macro. 


When you select a number, these options display: Location, 
Condition, Zap. 
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//Macro, Breakpoint, Location 


Specifies an unconditional breakpoint at a macro cell or file 
macro record. The spreadsheet location can be in a spreadsheet 
in memory or on disk. 


When you select Location, you’re given two options: Spreadsheet, 
File. 


Spreadsheet Sets up a breakpoint in a cell in a spreadsheet 
macro. If you set up a breakpoint in cell D10, 
the macro would go into STEP mode in cell 
D11 within the macro. 


File Sets up a breakpoint in a line in a file macro. 
If you set up a breakpoint in line 5, the macro 
would go into STEP mode in line 6. 


Example: 


The following file macro, S.xqt, is missing a right brace on line 3, 
so when the macro is run, it returns an error at or near line 3. 


{ENTRY OFF} 

/S~{BACKUP}A 

{ENTRYON 

{MESSAGE "Backup file saved."} 
{DELAY 5} 


WN" BO N e 


If you couldn’t find the problem, you could set up a breakpoint 
on line 2 to begin STEP mode on line 3, as follows: 


1. Select //Macro,Breakpoint, and select a number, 1. 

2. Then select Location,File. You’re prompted for the filename 
and the record (line number). Type S.xqt,2 and press 
Return. 


You have set up breakpoint 1; now invoke the macro. 
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//Macro, Breakpoint, Condition 


Specifies a conditional breakpoint at a cell outside the macro, in 
which a conditional formula is entered. 


m When the breakpoint formula becomes true, STEP mode is 
triggered. This is useful when checking values placed in the 
spreadsheet, or checking values in a conditional statement. 


m SuperCalc checks for the conditional breakpoints after each 
cell is executed. 


For example, the following macro is supposed to output the word 
Pass if you enter 1, and Fail if you enter 0. 


(GETNUMBER "Enter 1 for Pass and 0 for Fail." A6} 
(IF A6=1} {LET A7, "Pass") 
{LET A7, "Pass"} 


However, there is an error in the macro so that it always outputs 
Pass. If you couldn't see the mistake, you could set a conditional 
breakpoint in Z1 (any cell outside the macro), which contains the 
conditional statement, A 7="Pass". When you run the macro and 
enter 0, if the statement A7="Pass”, is true, then the macro would 
go into STEP mode so you could step through the macro and find 
the error. 


//Macro, Breakpoint, (1-8), Zap 


Clears the specified breakpoint. 


//Macro,Breakpoint,Zap 


Clears all breakpoints. 


//Macro,Analyze 


Analyzes the macro structure and creates a report of the macro 
range being analyzed. The report can be printed to the screen, to 
the printer, or to a file. The report can list: 
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m All macro cells in a macro range. 


m All macro names or cell addresses that call or branch to other 
macros, or are called by or branched from specified macros. 


m All macro names or cell addresses that may modify the 
contents of specified cells or a range, or may be modified by 
macro functions. 


This report is helpful when debugging a large macro with many 
routines. When you select //Macro, Analyze, the menu line 
displays these options: Go, Range, Type, Output, Quit. 


Use the following basic steps to analyze a macro range: 


1. Select //Macro,Analyze,Range and enter the macro range you 
wish to analyze. 


2. Select Type to specify the type of report you want. 


3. Select Output to send the output to the printer or file. The 
default is to the console. If you selected Printer or File, and 
you want to see your output on the screen, select Console. 


4. Select Go to execute the Analyze command. 


Each Type option you select is appended to the report. You can 
select all or some of the options depending on what you want to 
See. 


//Macro,Analyze,Go 


Executes the //Macro, Analyze command. 


//Macro,Analyze,Range 


Lets you specify the macro range to be analyzed (the whole 
macro range must be specified). You don’t need to include the 
labels or the comments. 
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//Macro,Analyze,Type 


Specifies which parts of the macro range are analyzed and listed 
in the report. Each report shows the macro name (where 
applicable), the corresponding cell, and the macro statement the 
cell contains. A report may contain one or more macro blocks. A 
macro block is a block of text cells, which contains a brace { or 
slash / or tilde ~ character, may be specified by a macro name 
(range name preceded by a backslash \), and ends with a non- 
text or empty cell. 


Contents 
Specifies whether a report will be created of all macro cells in the 


macro range. This is the default report type. 


Yes Creates a report that lists all macro cells 
included in the specified macro range. 


No Does not output a report for the Contents 
option. 


The following report is annotated to show the format of the 
Contents output: 


Macro Analyzer Output : MACRO CONTENTS : MAUTOEXEC [B91 


1) MAUTOEXEC 
2) [B9] 3) call INIT? 

1) PICK 
2) [B19] 3) tcall PICK_MAC+ 
2) [B11] 3) fcall SERVE_USER* 
2) [B121 3) fbranch PICK} 


1. Macro label (name) of the reported macro. 
2. Each cell address in the reported macro. 


3. Contents of each cell in the reported macro. 
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Transfers 


Lists all macro names or ranges that call or branch to macros 
inside specified macro routines. When you select Transfers, 
you're given the following options: 


To Lists all macro names or cell addresses called 
by or branched to, from specified macro 
blocks. The following report is annotated to 
show the format of the Transfers, To output: 


Macro Ánalyzer Output Screen 


Macro Analyzer Output : MACROS TRANSFER TO : MAUTOEXEC [B91 


1) MAUTOEXEC 
2) [89] tcall INIT> 
3) INIT [B14] 
1) PICK 
2) [B181] tcall PICK_MAC> 
3) PICK_MAC [B251 
2) [B111 {call SERVE_USER} 
3) SERVE_USER [B43] 
2) [B121] {branch PICK? 
3) PICK [B10] 


1. Macro label (name) of the reported 
macro (the cell which issues the 
call/branch). 

pa Cell address and contents of each 


calling/branching cell. 


3. Macro label and contents of the 
called/branched to macro. 
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From Lists all macro names or ranges that call or 
branch to macros inside specified macro 
blocks. The following report is annotated to 
show the format of the Transfers,From output: 


Macro Analyzer Output Screen 


o 
3 
Macro Analyzer Output : MACROS TRANSFER FROM : NCLEAR_PAN [B21] os 


ACLEAR_PAN [B211 
INIT [B141 
3) [B14] : call CLEAR_PAN“uindousoff > 
CALL_MAC [B991 
NAME1 [B103] 
NAME2 [B106] 
NAME3 [B1881 
NAME4 [B111] 
3) [B119] : 4panelon}{call CALL?4call CLEAR_PAN* 


Y. Macro label and cell address of the 
reported macro (the cell which is 


called/branched to). 

2. Macro label and cell address of the 
block containing the calling/branching 
macro. 

3, Cell address and contents of the 


calling/branching cell. 


Both Creates a report for both the To and From 
options. 

None Does not output a report for the Transfers 
option. 

Modifies 


Lists all macro names or ranges that modify or are modified by 
other macro blocks. When you select Modifies, you're given a 
choice of four options: 
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Affects Lists all cells Gn name or range) that may be 
affected by macro functions in a specified 
macro block. The following report is 
annotated to show the format of the 
Modifies, Affects output: 


Macro Analyzer Output Screen 


Macro Analyzer Output : CELLS AFFECTED BY : 1) NINIT [B141 


2) [B161 {let CURR_MAC B? 
3) CURR_MAC [B4] 

2) (8181 tgetkey "-- Press any key to continue --" KEY? 
3) KEY [B51 


i. Macro label of the block containing the 
modifying cells. 


z. Cell address and cell contents of the 
modifying cell. 


s, Macro label and cell address of the 
modified cell. 
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Changed-by Lists all macro blocks Gin name or range) that 
may modify the contents of specified cells or 
a range. The following report is annotated to 
show the format of the Modifies, Changed-by 
output: 


Nacro Analyzer Output Screen 


USPIS ‘z 
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Macro Analyzer Output : MACROS CHANGE : [A9] 
1) ENTRY [M81] 
1) WHILE (M881 
1) GET_COL [M911 
1) GET_DATA [M961] 


2) [M961] : tif IS_NUM=("'Num")}4getnumber "Enter number" [ccol:crou1+ 
1) ENTRY [M81] 
1) WHILE [M88] 
1) GET_COL [M911 
1) GET_DATA [M96] 
2) [M971 : tif IS_NUM=("Text")}tgettext "Enter text" Eccol+crowl? 


A Macro label and cell address of the 
block containing the modifying cells. 


e Cell address and contents of the 
modifying cell. 


Both Creates a report for both the Affects and 
Changed-by options. 


None Does not output a report for the Modifies 
option. 
//Macro,Analyze,Output 


Specifies whether the report is output to the Printer, to a File, or 
to the Console. 


Printer 


Prints the report to the printer. 
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File 


Prints the report to a .prn file. 


Console 


Prints the report on the screen. This is the default, unless Printer 
or File was specified. 


//Macro,Convert 


Converts Lotus 1-2-3 macros into a syntax SuperCalc can read, 
and returns Lotus 1-2-3 macros that have been converted to 
SuperCalc macros into the Lotus syntax. The conversion is a one- 
to-one correspondence between the Lotus commands and the 
syntax used by SuperCalc. 


//Macro,Convert, 123 


Converts Lotus 1-2-3 macros to a syntax SuperCalc can run. Most 
of the Lotus macro commands are converted to SuperCalc 
equivalent functions and commands. However, the slash 
commands remain in the Lotus slash command syntax, since 
SuperCalc contains the full Lotus menu tree and interprets most of 
the Lotus slash commands as SuperCalc equivalent commands. 
(The Lotus menu tree is accessed by selecting /1. See the /1 
section in this chapter for more information.) 


When you load a Lotus macro, all the cells are protected. Before 
converting, select /Unprotect, All to unprotect all the cells in the 
Lotus macro. 


All Lotus slash commands can be converted except for Graph and 
some of the Format commands. SuperCalc allows input to these 
commands so they won't stop the macro, but they have no effect. 


Conversion Considerations 


When a Lotus macro is converted, the following commands and 
functions are changed: 
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m Convert places a "1" after a slash (/) that is followed by a first 
letter from the Lotus main menu. The "1" flags SuperCalc to 
read subsequent characters as Lotus slash commands from the 
/1-2-3 Lotus menu. For example, a print command in a Lotus 
macro, 


/pprD6.J25-gq 


gy 
30 
30. 
a > 
o ~ 


would look like this after the conversion: 


/1pprD6.J25~gq 


m The /X option used by earlier versions of Lotus 123, is 
included in the Lotus tree of SuperCalc as a hidden option for 
macro conversions. When a /X command is converted, the 
"1" appears after the slash (/). For example: 


/X5Enter Number~A10~ (get number, 5, and 
place it in A10) 


converts to: 


/1X5Enter Number~A10~ 


Conversion Restrictions 
Before converting a Lotus macro, check for the following 


restrictions and edit the macro as needed: 


w In Lotus, Return after cell entry does not advance the cursor. 
When converting, toggle /Global, Next to off so SuperCalc will 
not advance the cursor when running the macro. 


w The following restrictions must be checked and fixed when 
line-wrapping occurs in the Lotus macro: 
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Function names and bracketed commands cannot be split 
into more than one line. You can, however, split the 
parameters. For example, the Lotus function, 
@SUM(A1.C1), cannot be split like this: 


as 
UM(A1.C1) 


But it can be split like this: 


@SUM 
(A1.C1) 


Ranges such as A1..A2 cannot be split. Convert would 
interpret a split range as a string, causing an error. 


Logic functions cannot be split. For example, 
@IF(1# and #2) cannot be split into more than one line. 


The EDATE(year,month,day) function cannot be split. 


Conversion Options 


You can convert all or part of the Lotus macro. hai 
All Converts all macros within the loaded 
spreadsheet. 
Range Converts the specified range within the 
spreadsheet. 
//Macro,Convert,SC 


Restores the converted Lotus macro to its previous state before 


//Macro, 


Convert was used. This is useful when saving 1-2-3 to a 


Lotus spreadsheet that contains a Lotus macro. 


You can restore all or part of the converted macro. 


All 


Range 
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Restores all macros within the spreadsheet to 
their previous state. e 


Restores the specified range within the macro 
to its previous state. 
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Special Considerations 


Naming Spreadsheet Macros 


Syntax to name a named range within a spreadsheet macro: 
text Enter any text string up to 32 characters. 


\text Precede any text string with a backslash to 
distinguish the named range used to invoke 
the macro the named ranges that invoke the 
macro subroutines. Using the backslash 
places the macro named range in the Macro 
Named/Range Directory, which lists all 


macros by spreadsheet (in load order). Press 


Alt—F3 to display the Macro Named/Range 
Directory. 


\x Enter a one-letter named range preceded by a 


backslash (such as \x). Lets you invoke the 
macro with the Alt-x command. You must 
precede the letter with the backslash when 
naming with one letter. 


\autoexec Invokes the macro automatically when you 
load the spreadsheet that contains it. 


Finding an \AUTOEXEC Spreadsheet Macro 


Since an \AUTOEXEC spreadsheet macro 
automatically executes when loaded, press 
CtrHEBreak to stop the macro, then press F5 and 
F3 to display the Named Range Directory. Select 
the \Autoexec named range and press Return to 
go to the cell named \AUTOEXEC. 
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Commands to name a spreadsheet macro: 


/Name, Create, (macroname), (range) Return 
or 


/Name, Labels, Right, (range) Return 


Saving and Loading Spreadsheet Macros 


/Save stores the spreadsheet macro with the spreadsheet .cal file. 


/Load retrieves the spreadsheet that contains the macro. To see 
the spreadsheet macro, press F5 then Alt-F3 to select the macro 
label from the Macro Name/Range Directory, or enter the top cell 
that contains the first macro statement. 


Building File Macros 


Observe these rules for file macros (.xqt files): 


Do not use a (CALL) command. 


Define labels to {BRANCH} to within the file by using the 
(LABEL label) command. 


If you put labels in the column to the left of the macro 
statements, when you create the file with //Macro, Write, 
SuperCalc converts these labels to (LABEL) commands and 
places them in the macro statements column. 


Except for Menus, do not include any blank or other nontext 
cells in the statements column. 


All the above commands are discussed in detail in Chapter 4. 
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Naming File Macros 
Syntax to name a file macro: 


filename Enter any valid DOS filename up to 8 
characters. 


The program appends an .xqt extension 
automatically if no other extension is specified 
within //Macro, Write. 


O 
3 
= 
w 
3 
Q. 
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x Enter one letter (such as x). Lets you invoke 
the macro with the ALT—x command from 
within the spreadsheet. 


SuperCalc first looks for a range named \x in 
all spreadsheets in memory, then in the 
current directory, then in the specified paths. 
If the range name does not exist, SuperCalc 
then seeks a file named X.xqt. 


autoexec Name the file macro AUTOEXEC.xqt to 


automatically invoke the macro when 
SuperCalc is loaded. 


Writing and Reading File Macros 

//Macro, Write (or Read), (filename), (range), All 

m filename is the name of the file macro. 

NW range is the top cell in the macro statements column. You 
must leave one column open to the left of the range to fit the 


macro labels. 


m All writes or reads the labels and comments columns along 
with the macro statements column. 


In place of All, you can specify Macros-only, Labels-macros, 
or Comment-macros. 
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//Network 


//Network 


In a supported network environment, //Network lets you access 
network resources such as files and printers. 


For information about installing and using SuperCalc on a 
network, see Chapter 5. 


Link, drive,network path 
Unlink, drive 
Lock, filename 
Unlock, filename 
Output, Quit 
12 EPI i : Redirect,network path 


//Network, - Directory, à Quit 


2 = LPT? End-redirection 
S= EPIS 


A network lets you share disk space and files on one or more 
network hard disks (called file servers), and network printers and 
plotters. 

Using //Network, you can: 

E Link to and unlink from any file server directory. 


E Lock and unlock shared data files. 


m Redirect spreadsheet or graphic output through any logical 
parallel port at your computer to a network printer or plotter. 


//Network has these options: Directory, Lock, Unlock, Output. 
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//Network,Directory 


Displays the Linked Network Directories screen that lets you link 
to or unlink from a file server directory. 


The options are: Quit, Link, Unlink. 


//Network,Directory,Quit 


SEIS “2 
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Returns you to the main Network menu. 


//Network,Directory,Link 


Lets you link, or connect, to a directory on the network using this 
syntax: 


//Network,Directory,Link, (drive),\ \ (server-name)\ (directory- 
name) 


or 

//Network,Directory,Link, (drive), (item)@ (group)@ (org) 
For example: 

//Network,Directory,Link,d:,\\server1\calc 

or 


//Network,Directory,Link,d:,work1@Eng@mycorp 


Password Protection 


If the directory is password protected, SuperCalc 
prompts you to enter the password and does not 
echo it to the entry line. Or, you can press 
Spacebar and add the assigned password after 
the directory name. 
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//Network,Directory,Unlink 


Disconnects you from the specified network directory. You can 
enter the letter of the drive to which you are linked, such as d:, or 
point to the drive on the Linked Network Directories screen and 
press Return. 


//Network,Lock 


Protects your files from alteration by another user. Locking is 
automatic when you load a file from a network server. Use Lock 
to protect supporting files that are not loaded. Lock gives you the 
exclusive right to save a file under its current filename. 


When prompted, enter the name of the file you want to lock. 
You can enter the full drive, directory, and filename; SuperCalc 
searches the default directory if you do not specify otherwise. 


If a file is locked by another user, you can still read and revise the 
file in browse mode, but you can only save it under a different 
filename. 


Lock as many files as you want, to prevent other users from 
changing your data during a work session. The number of files 
that you can lock simultaneously depends on the limits imposed 
by DOS or your network program. You can increase the DOS 
limits by using the DOS FILES= parameter in the CONFIG.sys file. 
We recommend FILES=20. (See your DOS manual for more 
information about FILES and CONFIG.sys.) 


Itis a good idea to lock file macros (after reading them with 
//Macro, Read) to prevent other users from altering the files while 
you're working with them. 


//Network,Unlock 


Brings up the Locked Files Directory so you can make locked files 
available to other network users by unlocking them. 


You can enter the filename, or point to the file you want to 
unlock on the Directory, then press Return. 


2-330 SuperCalc Reference Manual 


//Network 


Unlocking lets another network user load and save a previously 
locked file under the current filename. 


//Network,Output 


Displays the Network Output Redirection Menu, giving you a 
choice of three network ports: LPT1, LPT2, and LPT3. 


Select any one of the ports: 7, 2, or 3, or select Quit to return to 
the main //Network menu. 


If you select a port, the program prompts: Redirect or End- 
redirection. 


//Network,Output,Redirect 
Lets you redirect data to a printer or plotter at the network file 


server. See Example, below. 


//Network,Output,End-redirection 


Directs the output ports back to your local printer or plotter. The 
Network Output Redirection Menu indicates: LPT#: Not Redirected. 


Example 


To redirect spreadsheet output through network port LPT1 to a 
printer named LAS on a server named SRV1, enter: 


//Network,Output,LPT1,Redirect, \\SRV1\LAS 


At the Global Spreadsheet Options Menu, the Parallel Options 
Printer number must also be set to 1. 
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Special Considerations 


- 


If your network is set up to require passwords: 


m When you enter a password without a prompt, the 
password is echoed to (displayed on) the entry line. 


m When you enter a password following a password 
prompt, the password is not echoed to the entry line. 


A password cannot be read from a macro file. It must be 
entered from the keyboard. 


/Zap and //Spreadsheets, Zap unlock files that were 
automatically locked with /Load during the current SuperCalc 
session. /Quit unlocks all files that were locked — with Lock 
or automatically — during the current SuperCalc session. 


You can locate SuperCalc configuration (.c/g) files on a 
directory at (or linked to) your work station. You can create 
and update .cfg files with /Global, Keep, To. The .cfg files 
customize program defaults to your own requirements. 


If you turn off your workstation before exiting SuperCalc with 
/Quit, the network may still count your workstation as an 
active user — and a shared spreadsheet .cal file may remain 
locked. You can reboot that work station to resolve this 
problem. 
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//Restrict 


//Restrict limits data input to a specified range. 


//Restrict,range 


//Restrict lets you limit data entry to: 


E A specified range of cells only. 


E Occupied, non-protected cells only (with /Global, Tab on). 


When //Restrict is active, you're in INPUT mode. To exit from 
INPUT mode, press Return or Esc when the entry line is empty. 


This command is especially useful to macro template builders. 
Macros are suspended while in INPUT mode. 


Cursor Keys 


Use Arrow, Home, and End keys to move the 
cell cursor within the restricted range. The Tab, 
BackTab, PgUp, PgDn, and F5 (GoTo) keys are 
inactive in INPUT mode. 


For more about //Restrict, see Chapter 4 of the User's Guide. 
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//Spreadsheets 


Performs file-handling and display operations unique to multiple 
and multipage spreadsheets. 


//Spreadsheets, — Display, - 1 
2 
3 

Synchronize 

Unsynchronize 

Zoom, r Yes 

No 


Previous 
Specify,sheet/page 
Hide, sheet/page 
New 
Rename,name 
Save i Backup l 


Goto, ! Next 


Overwrite 
Unhide,sheet/page 
Zap, No 
l Ye 
Save s Backup | 
Overwrite 
Quit, — No 
- Ye 
Save i Backup | 
Overwrite 


Basic Concepts 


A spreadsheet is open when it is in memory. SuperCalc lets you 
open up to 255 spreadsheets simultaneously, depending on 
memory availability. To open new spreadsheets, use 
//Spreadsheets, New or CtrHEnter. You can use /Insert, Page to 
create multipage spreadsheets. 


Several cursor movement key combinations scroll among open 
spreadsheets and pages. Ctrl-Plus (+ on the numeric keypad) 
displays the next spreadsheet or page; Ctrl-Minus displays the 
previous spreadsheet or page (Chapter 1 contains a complete list 
of cursor movement keys). Spreadsheets and pages display 
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//Restrict 


//Restrict limits data input to a specified range. 


//Restrict,range 


//Restrict lets you limit data entry to: 


m A specified range of cells only. 


™ Occupied, non-protected cells only (with /Global, Tab on). 


When //Restrict is active, you're in INPUT mode. To exit from 
INPUT mode, press Return or Esc when the entry line is empty. 


This command is especially useful to macro template builders. 
Macros are suspended while in INPUT mode. 


Cursor Keys 


Use Arrow, Home, and End keys to move the 
cell cursor within the restricted range. The Tab, 
BackTab, PgUp, PgDn, and F5 (GoTo) keys are 
inactive in INPUT mode. 


For more about //Restrict, see Chapter 4 of the User’s Guide. 
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//Spreadsheets 


Performs file-handling and display operations unique to multiple 
and multipage spreadsheets. 


//Spreadsheets, — Display, — 1 
2 
3 

Synchronize 

Unsynchronize 

Zoom, r Yes 

No 


Previous 
Specify,sheet/page 

Hide, sheet/page 

New 

Rename,name 

Save ‘ Backup 
Overwrite 

Unhide,sheet/page 

Zap, Evo 


Goto, L Next 


Yes 
Save b Backup } 


Overwrite 
Quit, — No 
- Ye 
Save ‘ Backup 
Overwrite 


Basic Concepts 


A spreadsheet is open when it is in memory. SuperCalc lets you 
open up to 255 spreadsheets simultaneously, depending on 
memory availability. To open new spreadsheets, use 
//Spreadsheets, New or CtrHEnter. You can use /Insert, Page to 
create multipage spreadsheets. 


Several cursor movement key combinations scroll among open 
spreadsheets and pages. Ctrl-Plus (+ on the numeric keypad) 
displays the next spreadsheet or page; Ctrl-Minus displays the 
previous spreadsheet or page (Chapter 1 contains a complete list 
of cursor movement keys). Spreadsheets and pages display 
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according to their order on the Open Spreadsheet Directory, 
described later in this section. 


The current spreadsheet is the spreadsheet displayed on-screen, or 
the spreadsheet where your cursor is located if you’re displaying 
more than one spreadsheet with //Spreadsheets, Display. The 
name of the current spreadsheet appears at the beginning of the 
status line. SuperCalc uses this syntax to include spreadsheet 
names, pages, and page ranges in cell and range references: 


sheetname!page!cell references one cell on one page. 


sheetname!startpage.endpage!range references a range 
on a range of pages. 


See Chapter 3 for details on cell references and reference syntax. 


You can load, save, and clear individual spreadsheets and 
spreadsheet pages with the standard SuperCalc file handling 
commands: /Load, /Save, /Quit, and /Zap. Or, you can save all 
spreadsheets in memory and clear them with //Spreadsheets, Save, 
//Spreadsheets, Zap, Save, or //Spreadsheets, Quit, Save. 


Ctrl-F4 displays a list of spreadsheets in memory, the Open 
Spreadsheet Directory. It shows the unqualified filename without 
extension and the fully-qualified filename of any spreadsheet 
loaded from other than the default data directory. Each page is 
listed separately. An asterisk (*) displays in the H column to 
indicate hidden spreadsheets. You can move the bar cursor on 
the Open Spreadsheet Directory to select spreadsheets, 
spreadsheet pages, and page ranges in SHEET mode. The macro 
command equivalent for Ctri-F4 is {OSD}. 


When a formula in the current spreadsheet references another 
spreadsheet, either in memory or on disk, you create a 
spreadsheet link. You can press Ctri-E3 to display the 
Referenced Spreadsheet Directory, a list of spreadsheets linked to 
the current spreadsheet page. The Referenced Spreadsheet 
Directory indicates whether a linked spreadsheet is in memory or 
not and displays the fully-qualified filename for each linked 
spreadsheet. The macro command equivalent for Ctrl-F3 is 
{RSD}. You can change any portion of the name in the File 
column. The edited part displays in high-intensity type; the 
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original part displays in low-intensity type. See Spreadsheet 
Aliasing, later in this section, for more about name changing on 
the Referenced Spreadsheet Directory. 


//Spreadsheets,Display 


Displays up to three different spreadsheets or spreadsheet pages 
on-screen at the same time. Press Ctri-F6 to move from one 
window to the next. Ctri-Plus (+ on the numeric keypad) 
displays the next spreadsheet or page on the Open Spreadsheet 
Directory; Ctrl-Minus displays the previous spreadsheet or page 
(Chapter 1 contains a complete list of cursor movement keys). 
The equivalent macro command for CtrH-F6 is {SHEETWINDOW}. 


The display windows can be Synchronized or Unsynchronized. 
Synchronized is the default option; it displays spreadsheets and 
pages in the order they appear on the Open Spreadsheet Directory. 
Use Unsynchronized to display a particular spreadsheet in each 
window. Ctri-Plus and Ctri-Minus display the next spreadsheet in 
all open windows with Synchronized selected, but only affect the 
current spreadsheet when the display is Unsynchronized. See the 
User’s Guide for more on synchronization. 


When you save a multipage spreadsheet, SuperCalc saves the 
current //Spreadsheets, Display settings with the file. 


//Spreadsheets,Display,1 


Closes all but the current display window; the default SuperCalc 
display mode. 


//Spreadsheets,Display,2 
Opens a second spreadsheet display window; closes one window 


if three are currently visible. 


//Spreadsheets,Display,3 


Opens three spreadsheet display windows. 
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//Spreadsheets,Display,Synchronize 


The default multiple spreadsheet display mode; displays the 
current spreadsheet with adjacent spreadsheet pages. When you 
load a spreadsheet into the current window with replacement, its 
adjacent pages replace the spreadsheets displayed in the other 
windows. 


Scrolling is also synchronized. When you use CtrlPlus or 
Ctri-Minus to display the next or previous page in the current 
window, the spreadsheets displayed in the other windows also 
move forward or backward. 


o 
D 


- Spuewwog © 


//Spreadsheets,Display,Unsynchronize 


Each display window is independent of the others. When you 
display the next or previous page or spreadsheet, the other 
windows are unchanged. 


//Spreadsheets,Display,Zoom 


Toggles between multiple spreadsheet display and a full-screen 
display of the current spreadsheet. The command key equivalent 
is CtrL-F7. The macro command equivalent is ([OOMSHEET). 


//Spreadsheets, Display, Zoom, Yes 


Displays only the current spreadsheet, in normal full-screen 
display mode. 


//Spreadsheets, Display, Zoom, No 
Displays all open display windows. 


//Spreadsheets,Goto 


Displays the next, previous, or a specified spreadsheet or page 
according to the order on the Open Spreadsheet Directory. 
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//Spreadsheets,Goto,Next 


Displays the next spreadsheet or page; you can also use 
Ctrl-Plus (the + key on the numeric keypad). The equivalent 
macro command is {NEXTSHEET}. 


//Spreadsheets,Goto,Previous 


Displays the previous spreadsheet or page; you can also use 
Ctrl-Minus (the - key on the numeric keypad). The equivalent 
macro command is {PREVSHEET}. 


//Spreadsheets,Goto,Specify 


Displays the specified spreadsheet or page; you can also use 
CtrL-F5 followed by the name and/or page number of the target 
spreadsheet. The equivalent macro command is {GOTOSHEET}. 


//Spreadsheets,Hide 


Hides the specified spreadsheet, page, or page range. Select 
//Spreadsheets, Unhide to display it again. 


//Spreadsheets,New 


Opens a new blank spreadsheet in memory. CtrlReturn is the 
equivalent key command; (NEWSHEET) is the equivalent macro 
command. Once a new spreadsheet is open, you can build a 
spreadsheet there, or load or import an existing file into it. 


//Spreadsheets,Rename 


Renames the current spreadsheet with the name you specify. This 
name displays as the default filename when you save the file. 


//Spreadsheets,Save 


Saves all open spreadsheets that have been modified since the last 
save to disk. You can choose to Backup or Overwrite all existing 
files with the same names. 
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//Spreadsheets, Unhide 


Displays the specified spreadsheet, page, or page range after 
hiding it with //Spreadsheets, Hide. 


//Spreadsheets,Zap 


Clears all open spreadsheets, leaving the first page of TEMP1 
open. You can choose to save modified spreadsheets before 


Zapping. 
//Spreadsheets,Zap,No 


Returns to READY mode without clearing open spreadsheets. 


//Spreadsheets,Zap, Yes 


Clears all open spreadsheets, without saving them. 


//Spreadsheets,Zap,Save 


Clears all open spreadsheets, saving those that have been 
modified since the last save. You can choose to Backup or 
Overwrite existing files with the same names. 


//Spreadsheets, Quit 


Closes all open spreadsheets, and exits to the operating system. 
You can choose to save modified spreadsheets. 


//Spreadsheets,Quit,No 


Returns to READY mode without closing open spreadsheets. 


//Spreadsheets, Quit, Yes 


Closes all open spreadsheets without saving them and exits to the 


operating system. 


SuperCalc Commands 


2-339 


//Spreadsheets 


//Spreadsheets,Quit,Save 


Closes all open spreadsheets, saving those that have been 
modified since the last save. You can choose to Backup or 
Overwrite existing files with the same names. 


Special Considerations 


This section describes some features related to multiple and 
multipage spreadsheets that aren't governed directly by the 
//Spreadsheets command options. Chapter 10 of the User's Guide 
contains an overview of multiple spreadsheet applications. 


Cell Pointing 


Any command that works on a single-page spreadsheet will work 
on a spreadsheet page. //Import and //Export are similar to 
/Load, Single and /Save, Single, the current page is the default 
destination or source, respectively. /Edit and /Copy can accept 
from ranges on different pages of the current or other 
spreadsheets. /Copy also accepts to references on different pages 
and spreadsheets. When entering source and destination ranges 
for these commands, you can point to ranges in other 
spreadsheets as well as the current one: 


1. Type the formula or command sequence up to where you 
enter the range. 


2. Press CtriPlus or Ctrl-Minus to display the target 
spreadsheet and/or spreadsheet page; its name displays on 
the entry line. 


3. Type an exclamation point () or move the cursor to add an 
exclamation point and move into the displayed spreadsheet. 
You can then point to a cell range or use F3 to display the 
Named Range Directory and make your selection there. If 
you're entering a formula, end it with a parenthesis: ). 


4. Press Return to enter your selection. Press Esc to leave the 
spreadsheet without selecting a cell or range. 
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Pointing to Page Ranges 


You can enter a range of pages within a spreadsheet when you're 
moving, inserting, or deleting pages. You can also combine page 
ranges with cell ranges in formulas to work in three dimensions. 


To specify a range of spreadsheet pages in POINT mode, press 
CtrL-Plus or Ctrl-Minus until the first page in the range displays. 
Then, type a period (.) or colon G) to anchor the page range and 
continue with Ctri-Plus or Ctri-Minus until the last page in the 
range is on-screen. If you're selecting a range of pages to move, 
insert, or delete, press Return to enter the range. If you move 
the cursor or type an exclamation point, you'll move into the 
displayed spreadsheet and can point to a range there. 


You can also use the Open Spreadsheet Directory for page range 
pointing. Press Ctri-F4 to display it, move the highlight to the 
first page in the range, and anchor the range with a period or 
colon. Then, highlight the end of the range and press Return. If 
you're selecting only pages, press Return again or enter a comma 
(,) to continue with a command sequence. If you need to 
reference a cell or range, type it in. 


Spreadsheet Aliasing 


You can edit the File column of the Referenced Spreadsheet 
Directory to associate a different filename with a name in the 
Name column. The new filename can be fully-qualified or just a 
nickname — the basic filename without drive/directory path. If 
you enter a nickname, SuperCalc will search for the appropriate 
file (see File Retrieval, Chapter 1). 


When you enter a different filename in the File column, all link 
formulas using the name shown in the Name column will 
reference the new filename. 


Filename changes are useful when working with spreadsheet 
templates and models. You can develop a spreadsheet using 
generic names in link formulas. Then you can analyze different 
data sets without loading a new spreadsheet each time. Just 
change the source spreadsheet name(s) in the Referenced 
Spreadsheet Directory File column and recalculate. To keep a 
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permanent record of your results, save the spreadsheet under a 
different name after each recalculation. 


For example, you can build a spreadsheet that reads and 
processes data from regional sales spreadsheets. The model 
spreadsheet refers to the source spreadsheet as SALES!, but you 
can edit the File column before each recalculation to associate 
SALES with spreadsheet files WESTSALE.cal and EASTSALE.cal. 
or ¢:\WEST\SALE.cal and c:\EAST\SALE.cal, depending on 
how your directories and files are organized. 


Using aliases helps ensure that your formulas contain meaningful 
spreadsheet names. Suppose spreadsheet TOM1 contains budget 
data. You can reference BUDGET! in your formulas, then enter 
TOM1, fully-qualified or not, in the File column of the Referenced 
Spreadsheet Directory. Then, all references to BUDGET actually 
read data from TOM1. 


Pages versus Sheets 


SuperCalc lets you work with multiple and multipage 
spreadsheets in several different ways. You can load: 


m More than one single-page spreadsheet. 
m A single multipage spreadsheet. 


NH More than one multipage spreadsheet. 
E Any combination of single-page and multipage spreadsheets 


Single-page spreadsheets are more useful for some purposes, 
while multipage spreadsheets work better for others. This section 
describes some of their differences and suggests when to use 
each type. 


E Single-page spreadsheets are saved and loaded separately. 
All pages in a multipage spreadsheet are saved and loaded as 
one. 
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m Pages in a multipage spreadsheet are ordered, so you can 
specify page ranges such as SUM(1.3!A1:B10). Spreadsheets 
with this capability are sometimes called multidimensional 
spreadsheets. You can reference the same named range on 
each page — SUM(1.3!FRED) — regardless of the size or 
location of that range on each page. You can also specify a 
“cookie-cutter” range on the first page, preceded by a $ — 
SUM(1.3!$FRED). This means that range FRED on the current 
page defines the exact cells to use on the pages in the range, 
regardless of whether FRED exists on the other pages or 
where it is located, if present. 


Single-page spreadsheets are loaded independently of each 
other and are not ordered. 


m Multipage spreadsheets usually have all pages in memory, 
which makes them convenient for browsing, pointing, and 
updating. 


Single-page spreadsheets can be conveniently linked on disk, 
saving memory. 


You may find it practical to use multipage spreadsheets for 
consolidations, where a summary spreadsheet is backed up by 
several other sheets — departments or sales regions, for example. 
Multipage spreadsheets are also helpful where each page has an 
identical layout and “cookie-cutter” ranges are appropriate. 


Single-page spreadsheets are typically used when cells are linked 


to several different spreadsheets that don’t need to be loaded or 
viewed together. 


SuperCalc Commands 2-343 


//Test 


//Test 


-SuperCalc offers many commands for auditing spreadsheet data 
and analzing cell relationships. //Test puts you in AUDIT mode, 
which has its own menu tree of auditing commands and 


operations. 


/ - Details 
Highlight, — Area, 


Filter, All 


Current 


Highlighted 
Not-highlighted 


Range, range 


Block, range 


Cells, 


Find, 


y 


Attribute 

Blank-ref 

Constant 

Date 

Error 

Formula 

Hidden 

Invariant 

Lone 

Macro 

NA 

fOrmat 

Protected 

Referenced 

String 

Time 

Unprotected 

emptY 

Contents, — Go 
Case, 


Labels, 


Match, 


Any 
Exact 
Yes 

L No 
Begins 
Contains 
Exact 


Terminates 
Word 


Relation, E Equal 


Not-equal 


String,string 


Quit 
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e Numbers, — Go 
Relation, - Equal 
Not-equal 
Above 
Below 
Greater/equal 
Less/equal 
Value,value 
Quit 
Text Go 
Case, Any 
Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Relation, paa 
Not-equal 
String,string 
Quit 
Links, Dependent 
Modified, Yes 
No 
Output-attr, All 
Border, All 
Top 
Bottom 
Left 
Right 
Fonts, All 
1 
2 
3 
4 
5 
6 
ri 
Shade 
Pre-zap, Yes 
No 
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Relationships, Circ 
Dependent, p Direct 
Nested 
Group, All 
- First 


None 
Supporting, pr Direct 
Nested 
Zap 
Names, Bounds 
Duplicate 
Overlap 
Reversed 
Unreferenced 
Replace, Go 
Range,range 
Old-string, string 
New-string, string 
Case, Any 
| Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Prompt, - Yes 
No 
Labels, Yes 
No 
Quit 
Squeeze 
View, Normal 
L Formula 
Map, Pattern 
Standard 
Quit 


Appendix B, Troubleshooting: AUDIT Mode describes the //Test 
commands and their options. 
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Formulas and Functions 


What’s in this Chapter? 


While word processors manipulate text and databases store and 
retrieve information, electronic spreadsheets calculate data and 
report the results. SuperCalc performs many word-processing and 
database operations, but its ability to evaluate data with formulas 
and functions remains a central feature. 


This chapter tells how SuperCalc handles formulas and functions 
to perform a variety of calculations and related tasks. The first 
part gives basic rules for constructing and using formulas. The 
second part lists and describes SuperCalc’s prepared functions 
with examples of their use. 


Formulas 


Data Types 

SuperCalc has five basic data types: 
E Numeric 

Date/Time 

String 


Error 


N/A 
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Numeric Data 


The numeric data type includes integers, decimals, exponents, 

and percentages. SuperCalc has no logical data type as such, but 

throughout the program 0 is evaluated False by logical functions 

and anything else is evaluated True. Numeric data is evaluated as -r 
"" (the null string) when used in a string context. 


Date/Time Data 


In SuperCalc, dates and times are part of a single data type. 

Dates are based on the integer part of a date/time value, while 
the decimal part of a date/time value represents time. The 
function JDATE must have arguments greater than 1; all other date 
and time functions accept any date/time value. 


You define date and time formats with /Format, User-define, Date. 
There are format tokens for both dates and time: they can be 
mixed in one format. The display of date/time values is governed 
by the format applied to them. If a date/time value is less than i 
but the applied format contains no time tokens, the default time 
format, Twill display. 


String Data 


strings are any type of text: Text, Repeating Text, or Control 
Text. Text may be up to 240 characters in length and has the 
value of 0 when used in a numeric context. 


Error Data 


This data type is assigned to cells that return a value that cannot 
be calculated. You can enter the value type ERROR, a function, 
directly into a cell. Any formula that calculates with an ERROR 
value results in another ERROR value. 


N/A Data 


SuperCalc displays N/A in a cell for which data are not available. 
You can enter the value N/A into a cell using the function NA. 
Any formula that calculates with an N/A value results in another 
N/A value. 
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Formula Definition 


A formula is a series of operators and operands arranged to form 
an algebraic expression. The operators are mathematical symbols 
such as + and -. The operands are the constants, cell references, 
functions, and other formulas acted upon by the operators. The 
minimum formula is a single operand. 


Some formulas are used frequently to solve problems in research, 
engineering, finance, and other fields. SuperCalc includes many 
of these formulas permanently stored in the form of functions. 


Operands 


Operands are the values of a formula that are manipulated by the 
formula operators. In the formula A + B, A and B are the 
operands and + is the operator. An operand can be any of the 
value types: numeric, date/time, string, Error, or N/A. It can be a 
constant, a cell address, a function reference, or another formula 
enclosed in parentheses. The following section discusses constant 
operands. See Cell Address and Extended Cell Address, later in 
this chapter, for more information on cell references. 


Constants 


There are two types of constants: numeric and string. 


Numeric Constants 


Numeric constants are any number such as an integer or decimal 
number or an exponential number. SuperCalc accepts a 
maximum of 16 decimal places for a numeric constant. 


Numbers are accurate up to 15 significant digits. Integers in the 


range -999999999999999 to 999999999999999 (-10A16 and 10416) 


are stored exactly. 


Numbers that are not integers or are outside the integer range are 
stored as exponential (floating point or scientific notation) 
numbers, and are rounded to 15 significant digits. You can enter 
numbers with an exponent from -63 to +62. 
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Exponential (floating point) range: 


-9.99999999999999e62 -1e-63 1e-63 9.99999999999999e62 


| SAME | 


String Constants 


SuperCalc lets you enter text into a cell and then reference the 
cell content either directly or in a formula. When used in this 
way, text can be considered a string constant. 


You can use string constants to construct lookup tables and in 
conditional expressions. String constants can be merged with the 
concatenation operator (&), and can be evaluated with the string 
functions. 


String constants can be up to 240 characters long. When used 
with text, the = operator is case insensitive: Dog is equal to dog. 


Cell Address has? 


You can use the value of a cell as an operand in a formula by 
naming the cell address. For example, 5+D8 is a valid formula 
that states, “Add 5 to the value of cell D8.” You can also 
reference cells by name (DISCOUNT, for example). These are all 
valid cell addresses: 


Al 

SAS1 

NAME (of a cell) 
SNAME (of a cell) 
[column;row] 
NAME[column;row] 


The value type of the referenced cell applies directly to the > 
formula. Cell references can be relative, absolute, or computed. 
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Relative Cell References 


These are standard cell addresses, naming the column letter and 
row number of the referenced cell. When a formula with a 
relative cell reference is copied with adjustment, relative cell 
references change appropriately for their new location. If the 
function ABS(A1) is copied from cell A7 to cell B7 and adjusted, 
it will then read ABS(B1) (see Formula Adjustment, later in this 
chapter, for details). 


Absolute Cell References 


An absolute cell reference is not adjusted for location when the 
cell containing it is copied, even when copied with adjustment. A 
S before either or both parts of a cell reference indicates that 
coordinate is absolute. For example, $A$1 represents an absolute 
reference to cell Al. If you copy a formula with this reference 
from B1 to C2 (increasing the row and column by one), it will 
continue to reference Al. A$1 represents a reference to Al with 
only the row as absolute. If you copy a formula with this 
reference from B1 to C2, the column will increase from A to B, 
but the row will remain 1. 


When you're entering a formula, the F4 key rotates a cell 
reference from relative (the default) to absolute: 


A1, then SAS1, then A$1, then $A1, then A1 


Named Cells 


You can use /Name, Create to assign a name to a cell. Then, 
whenever you use that name in a formula, SuperCalc will 
substitute the appropriate cell. F3 displays a list of named ranges, 
including single-cell ranges. When the named cell is moved, the 
name will be matched with the new location on the Named Range 
Directory. 
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Absolute Named Cells 


After naming a cell with /Name, Create, you can enter the name 
into a formula preceded by $ to make the name absolute. For 
example, if you assign the name TOTAL to A1, then $TOTAL = 
$A$1. When you move an absolute named cell, it won't adjust; if 
you add or delete blocks, columns, or rows that affect its location, 
it will adjust (see Formula Adjustment, later in this chapter). 
Names cannot be used for a mixed relative/absolute cell 
reference, like $A1 or A$1. 


Computed Cell References 


You can enter a computed cell reference in place of a cell address 
in formulas and commands. The basic syntax for a computed cell 
reference is: 


[column number;row number] 


This form allows you to specify a column as a number instead of 
the usual letter convention. For example, cell address C2 has the 
cell reference [3;2] because that cell is in the third column and 
second row. 


Computed cell references can contain formulas. For example, 
[Z1+1;Z2] is the cell reference for cell C4 when the value of Z1 is 
2 and the value of Z2 is 4. You can perform cell address 
arithmetic. 


Computed cell references can be specific to column or row. For 
example, you can specify column B as [2] or [2;] and row 2 as [;2]. 


You can also base computed cell references on a range name: 


NAME[column;row] 


Here, the reference is to a cell in a particular range, where 
NAME[1;1] is the cell in the upper-left corner of that range. 


If a computed cell reference is not preceded by a range name, the 


reference is taken to refer to the spreadsheet as a whole, and the 
basic syntax rules given earlier in this section apply. 
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Extended Cell Address 


SuperCalc’s complete reference syntax includes the spreadsheet 
name, spreadsheet page or page range, range, and/or cell 
reference. The spreadsheet name is followed by an exclamation 
point. If the referenced spreadsheet has more than one page, 
these can be included in the reference following the spreadsheet 
name. Page numbers are expressed with an exclamation point 
following them. You can reference pages in the current 
spreadsheet by number only; no spreadsheet name is necessary. 
The cell address follows the spreadsheet name or page number if 
present. These are all valid cell address forms: 


page!cell_address 
sheetname!cell_ address 
sheetname!page!cell_address 
sheetname! page![column;row] 


sheetname! page!NAME[column;row] 


Function Reference 


A function reference is a function and its arguments, if any, used 
as an operand, for example: SUM(RANGE) in B1 + 
SUM(RANGE). See Functions, later in this chapter, for a 
description of SuperCalc's functions. 


Formula Evaluation 


Formulas enclosed in parentheses can be used as operands, for 
example: A1+(C2-D6). Parentheses can be nested; the innermost 
set is evaluated first, for example: A9/(B2*(E3-D8)). This 
formula means, “Subtract D8 from E3. Multiply the result by B2 
and divide that result into A9.” . 
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Operators 


SuperCalc uses three types of mathematical operators: arithmetic, 
relational, and string. 


Arithmetic Operators 


An arithmetic operator defines the arithmetic operation performed 
between two operands. SuperCalc uses these operators: 


+ Unary plus (positive) 

- Unary minus (negative) 
PEE Exponent 

% Percent 

/ Division 

P Multiplication 

+ Addition 

- Subtraction 


The arithmetic operators are evaluated according to algebraic 
precedence. The unary plus and unary minus (signs that precede 
a value such as -3) are always evaluated first. The exponent 
operator is evaluated next. Then the multiplication, division, and 
percent operators are evaluated. The addition and subtraction 
operators are evaluated last. 


Parentheses define the precedence order of calculation within a 
mathematical formula. Operations enclosed within parentheses 
are calculated first. The use of parentheses overrides the 
algebraic precedence order of arithmetic operators. Parentheses 
can be nested. 

Examples: 


4+5*2A2 is the same as 4+(5*(2A2)) or 24 


-2^2 is the same as (-2)A2 or 4 
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Relational operators compare two operands and return a value of 
True or False. A true comparison has a numeric value of 1; false a 
numeric value of 0. 


The following example compares terms a and b using the 
relational operators: 


a=b Equal: The relation is True (1) if, and only if, 
a is equal to b. All other cases are False (0). 


a<>b Not Equal: The relation is True (1) if a does 
not equal b. All other cases are False (0). 


a<b Less Than: The relation is True (1) if the 
value of a is less than the value of b. It is 
False (0) if the value of a is greater than or 
equal to b. 
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a>b Greater Than: The relation is True (1) if the 
value of a is greater than the value of b. It is 
False (0) if the value of a is less than or equal 
to b. 


a<=b Less Than or Equal To: The relation is True 
(1) if the value of a is less than or equal to 
the value of b. It is False (0) if the value of a 
is greater than the value of b. 


a>=b Greater Than or Equal To: The relation is 
True (1) if the value of a is greater than or 
equal to the value of b. It is False (O) if the 
value of a is less than the value of b. 


You can use the relational operators = and <> to compare any of 
the value types. The other relational operators can compare 
numeric, date, time, and string values only. A reminder: B =D is 
case insensitive. 
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String Operator 


SuperCalc has a single string operator, &. This is the 
concatenation operator that combines "string1"&"string2" into 
"stringlstring2". For details, see & in the function description 
section later in this chapter. 


Ranges 


Cell Ranges 


Cell ranges may only be included in SuperCalc formulas as part of 
function references, for example AVG(D6:E9)+2. The range 
delimiter can be either a colon or a period: D6:E9 = D6.E9. 


Ranges can be expressed as two computed cell references: 


[column1;row1]:[column2;ro0w2] 


Computed cell references can be used to define a range. For 
example, [4;4]:[5;5] is the same as the range D4:ES. 


You may also refer to subranges of a named range: 


NAME[column1;row1]:[column2;row2] 


“Cookie-Cutter” Ranges 


When working with multipage spreadsheets you can use all 
standard range references: upper-left cell:lower-right cell, 
[column;row]:[column;row], NAME, and 
NAME[column;row]:[column;row]. You can also specify a 
“cookie-cutter” range on the current page, NAME preceded by a $ 
(following the spreadsheet/page reference) — for example, 
SUM(1.3!$FRED). This means that range FRED on the current 
page defines the exact cells to use on the pages in the range, 
regardless of whether FRED exists on the other pages or where it 
is located, if present. 
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Page Ranges 


Because the pages of a multipage spreadsheet are ordered, you 
can define page ranges: 


sheetname!startpage.endpage. 


You can use page ranges in formulas, for example: 
SUM(sheetname!startpage.endpage!range), or 
SUM(BUDGET!3.6! TOTAL1) 


Invariant Formulas 


An invariant formula is a formula that never changes. Invariant 
formulas contain no cell or range references, nor any reference to 
any of the following functions or their abbreviations: 
CURADDRESS, CURCOL, CURPAGE, CURROW, CURSHEET, ITER, 
LASTCOL, LASTROW, RANDOM, THISCOL, THISROW, TODAY, 
NOW, or @. 


Formula Adjustment 


Adjustment with /Copy 


If you enter the formula SUM(A1:A6) into cell A7 and then use 
/Copy to copy that formula to cell B7, it will adjust and become 
SUM(B1:B6). If you don’t want one or both parts of the cell 
reference to adjust, you can precede that part with a $ to make it 
absolute. For example, SAS1 won't adjust at all, but A$1 will 
adjust for column but not row, while $A1 will adjust for row but 
not column. No other part of the spreadsheet adjusts following 
the use of /Copy. 


Adjustment with /Move, /Insert, /Delete 


If you use /Move to move the SUM(A1:A6) from A7 to B7, it 
doesn’t adjust; it is still SUM(A1:A6). However, all formulas that 
referenced cell A7 are adjusted to reference B7. For example, if 
cell C1 contained the entry A7 — or even $A$7, after the move 
the entry adjusts to B7, or $BS7. 
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The same type of adjustment follows after you insert or delete a 
row, column, or block of cells. SuperCalc keeps track of which 
formulas are affected and updates them, even if their references 
are absolute. For example, if you insert a column at B, so the 
original column B becomes C, formulas that referenced cells in 
column A won't change, but all other formulas will change — a 
reference to D7 or $D$7 will become E7 or $E$7, and so on. 


Range Adjustment 


Suppose you create the named range FORECAST as G5:H8 and 
then enter the function SUM(FORECAST) in cell Al. If you copy 
A1 to A3, this function displays in A3: SUM(G7:H10). The range 
adjusts and no longer references FORECAST. 


To copy a named range without adjustment, place a $ before the 
name when entering it: SUM(SFORECAST). Now, if you copy 
Al to A3, the same function displays in both cells with 
/Global,Labels on. If you turn /Global, Labels off, the range 
displays as absolute cell references: $G$5:$H$8. 


When you copy a formula using a named range from one 
spreadsheet to another, it doesn’t adjust — just as if you entered 
the name with a $ before it. 


If an insertion or deletion occurs within a range, the range 
definition will expand or contract to match. For example, if 
column D is deleted, SUM(B6:F25) will become SUM(B6:E25). 
Definitions of named ranges displayed in the Named Range 
Directory will reflect the adjustment. 
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The SuperCalc functions are predefined formulas that perform a 
variety of useful calculations. A function is similar to a symbol 
operator, such as + or -; it produces a new value from other 
values. For example, some functions produce strings from 
numeric values, others calculate financial data and yet others 
perform calculations on dates and times. 

SuperCalc functions fall into the following general categories: 
Logical 

Calendar 


Financial 


Index 


Statistical 
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Data Management Strtistical 
Arithmetic 
Trigonometric 


String 


Special Purpose 

This section provides information on each function available in 
SuperCalc, including: 

m Discussion of function syntax and arguments. 

NW Summary listing of functions by category. 

m Overview of function categories and uses. 
8 


Detailed alphabetic directory of functions. 
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Syntax 


You can use a function by itself, or combine functions into 
complex formulas. Each function has a unique name and most 
functions accept arguments. 


The general format for a function is: 
FUNCTION (argumentl,argumentz,...,argument) 


m Every function returns a single value; the data type of the 
returned value depends upon the function itself. 


m You can enter a function in either uppercase or lowercase 
letters. SuperCalc converts all formulas to uppercase 
automatically, including functions. 


m If you name a range (using /Name) with one of the function 
names, that function will no longer be accessible. For 
example, if you name a range SUM, then SUM(A10:F10) 
becomes meaningless. 


Arguments 


Different functions require different data types as arguments. You 
must supply the proper data type. For example, SUM(ist) 
requires a list of numeric data while MONTH(date value) requires 
a date value. 


1. Enclose arguments in parentheses. In complex formulas, be 
sure that each left parenthesis is closed by a right parenthesis. 


2. Separate multiple arguments with the current punctuation 
mark for operands, such as a comma (, ). See 
/Global, Optimum, Present for the current punctuation mark 
settings. 


3. Separate cells in a range with a colon (:) or period (. ). 
4. A list consists of any number of cell ranges or individual 


values, each separated with a comma (or the appropriate 
punctuation mark). 
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Blanks within arguments are deleted automatically 
SUM( 1,2 , 3 ) = SUM(1,2,3). 


You can use a cell address or range name as an argument. 
When you refer to a cell in this way, that cell must contain 
the data type that the argument requires. 


Single-Value Arguments 


If the argument calls for a single cell, then the 
named ranges must be single cells or used in a 
formula that results in a single value (e.g., if 
DOG is the name for range Al:A3, saying 
CHOOSE(0,DOG) results in the text DOG. 
CHOOSE(O,SUM(DOG)) however, returns the 
sum of the range DOG because SUM(DOG) 
represents a single value. 
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You can “nest” functions by using one function as an 
argument of another function — see Single-Value Arguments, 
above. 


When you make an error entering a function, such as entering 
the wrong data type or a numeric value that is out of range, 
SuperCalc does one of two things: 


m When /Global," is off SuperCalc enters the erroneous 
formula as text (supplying the necessary opening double 


quotation mark). This is the default state. 


E When /Global, "is on SuperCalc displays Formula error 
and returns you to the edit line to correct the error. 
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Summary of Functions 


There are ten categories of SuperCalc functions. The following 
list summarizes each of the functions by category. 


Logical Functions 


Function 


Cell Type Test 


ISBLANK(expression) or 
ISB(expression) 
ISDATE(expression)or 
ISD(expression) 
ISERROR(expression) or 
ISERR(expression) or 
ISE(expression) 
ISNA(expression) 


ISNUM(expression) or 
ISN(expression) 
ISPROT(cell) 
ISSTR(expression) or 
ISS(expression) 
ISTIME(expression) 


ISVAL(expression) or 
ISV(expression) 


Cell Type Assignment 


ERROR or ERR 
FALSE 

NA 

TRUE 


Conditional Logic 
AND(valuel,value2) 
EXACT(string1,string2) 


IF(cond,x,y) 
NOT(value) 
OR(value1,value2) 


Returns 


True if expression is a blank cell 
True if expression is date value type cell 


True if expression returns ERROR value 


True if expression returns Not Available 
(N/A) 
True if expression returns numeric value type 


True if cell is protected 
True if expression returns text or string 


True if expression is a date value type cell 
with value <1 
True if expression returns numeric value 


Displays ERROR 

Displays O for logical value False 
Displays N/A for Not Available 
Displays 1 for logical value True 


True if value1 and value2 are true; otherwise 
False 

True if string1 and string2 match; otherwise 
False 

X if cond is True; Y if cond is False 

True if value is False; False if value is True 

True if any value is true; otherwise, False 
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Function 


Date/Time Entry Functions 


DATE(mm,dd,yy) or 
DAT(mwm,dd, yy) 
EDAT(dd,mm,yy) 
DATEVALUE(date value or 
string,fstring) 


DVAL(value) 

NOW 

TODAY 

TIME(hh,mm,ss) 

TIMEVALUE(time value or 
string) or 

TVAL(time value or string) 


Date/Time Reference Functions 


DAY(value) 


HOUR(value) 


JDATE(date value) 
JTIME(time value) 
MINUTE(value) 


MONTH(value) or 
MON(value) 
SECOND(value) 


YEAR(value) 


WDAY(date value) 


Financial Functions 


Annuities (Lifetime) 
ANRATE(payment, present 
value, term) 
ANTERM(payment,rate, 
present value) 

PMT(present value,rate,term) 
PV(payment,rate,term) 


Functions 


Returns 


Date value of specified date 


Same as DAT; European parameter order 

Converts string, date value, or integral 
portion of Julian date/time into a 
date-formatted value 

Date value of specified value 

System date and time 

System date 

Time value of specified time 

Converts string, time value, or fractional 
portion of Julian date/time into a time- 
formatted value 


Number of the day of the month of date 
value or integral portion of Julian 
date/time 

Hour corresponding to hour portion of time 
value or fractional portion of Julian 
date/time 

Julian date of date value 

Julian time of time value 

Minute corresponding to the minute portion 
of time value or fractional portion of 
Julian date/time 

Number of the month of date value or 
integral portion of Julian date/time 

Second corresponding to the minute portion 
of time value or fractional portion of 
Julian date/time 

Number of the year of date value or integral 
portion of Julian date/time 

Julian number of day of week of date value 


Periodic interest rate 
Number of payment periods 


Equal periodic payment 
Present value of a series of payments 
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Function 


Annuities (Periodic) 
BALANCE(present 
value,rate,term, period) 
KINT(present 
value,rate,term, period) 
KPRIN(present 
value,rate,term, period) 
PAIDINT(present 
value,rate,term, period) 


Onetime Investments 
CTERM(rate, future value, 
present value) 
COMPBAL(present value, 
rate,term) 

RATE(future value, present 
value, term) 


Investing Each Period 
FV(payment,rate,term) 
IRR(guess,row/col range) 
NPV(rate,row/col range) 
TERM(payment,rate, future 
value) 


Depreciation 
DDB(cost,salvage,life, period) 


SLN(cost,salvage, life) 
SYD(cost,salvage,life, period) 


Index Functions 


ADDRESS(range) 
BEGCOL(range) or 
BCOL(range) 
BEGROW(range) or 
BROW(range) 
CHOOSE(x,v0,v1,...,vn) 
COLCHARS(value) 


COLS(range) 
CURADDRESS 
CURCOL or CCOL 
CURPAGE 
CURROW or CROW 
CURSHEET 


Returns 


Remaining principal balance after period 
payments 
Amount of interest paid in period 


Amount of principal paid in period 


Total interest paid to period 


Number of periods (term) 
Final balance in an account 


Periodic interest rate 


Future Value 

Internal Rate of Return 

Net Present Value of a group of cash returns 
Number of periods 


Depreciation allowance using the double- 
declining balance method 

Straight-line depreciation for one period 

Sum-of-the-years digits depreciation for 
specified period 


Cell address of upper-left cell in range 
Column number of upper-left cell in range 


Row number of upper-left cell in range 


The xth value from the list of values 

Takes a number from 1 through 255 and 
returns the equivalent column string, A 
through IU. 

Number of columns in range 

Current cell address 

Column number of the current cell 

Number of current spreadsheet page 

Current row number 

Name of current spreadsheet 
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ENDCOL(range) or 
ECOL(range) 

ENDROW(range) or 
EROW(range) 
HLOOKUP(x,range,row offset) 
or HLU(x,range,row offset) 


INDEX(range,column offset, 
row offset) 

ITER 

LASTCOL or LCOL 
LASTROW or LROW 
LOOKUP(value,row/col range) 
or LU(value,row/col range) 
N(cell) 

ROWS(range) 

S(cell) 

THISCOL or TCOL 
THISROW or TROW 
VLOOKUP(x,range,column 
offset) or 
VLU(x,range,column offset) 


Statistical Functions 


Function 


AVERAGE(list) or 
AVG(list) or AV(list) 
COUNT (list) 

MAXd(list) 

MIN(list) 

RANDOM or RAND or RAN 
STD (list) 

SUM(list) 

VAR(list) 


Functions 


Column number of the lower right cell in 
range 
Row number of the lower right cell in range 


Content of the cell in the horizontal table 
specified by range, beneath column x, in 
the row defined by row offset 

The value of the cell in range at column 
offset and row offset 

The current iteration count 

Rightmost column number containing data 

Bottom row number containing data 

Last value in range that is less than or equal 
to value 

Numeric value of cell 

Number of rows in range 

String value of cell 

Column number of the cell 

Row number of the cell 

Content of the cell in the vertical table 
specified by range, across row x, in the 
column defined by column offset 


Returns 


The average (mean) of the list 


The number of numeric value cells in /ist 
Maximum value in /ist 

Minimum value in /ist 

Random number between 0 and 1 
Standard deviation of a population in /ist 
Sum of the values in /ist 

Population variance of the values in list 


Data Management Statistical Functions 


Function 


DAVG(input, offset field, 
criterion) 
DCOUNT(input,offset field, 
criterion) 

DMAX(input, offset field, 
criterion) 

DMIN(Gnput, offset field, 
criterion) 


Returns 


Mean (average) of values in offset field of 
input range that meets criteria 

Number of non-blank, non-zero cells in offset 
field of input range that meets criteria 

Largest value in offset field of input range 
that meets criteria 

Smallest value in o/fset field of input range 
that meets criteria 


ey 
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DSTD(nput, offset field, 


criterion) 


DSUM(input,offset field, 


criterion) 


DVAR(input, offset field, 


criterion) 


Arithmetic Functions 


Function 


ABS(value) 
EXP(value) 
INT(value) 
LN(value) 


LOG10(value) or LOG(value) 


MOD(valuel,value2) 


ROUND(value, places) 


ROUNDUP(value, places) 


SQRT(value) 
TRUNC(value, places) 


Trigonometric Functions 


Function 


ACOS(value) 
ASIN(value) 
ATAN(value) 
ATAN2(x,y) 
COS(value) 
PI 
SIN(value) 
TAN(value) 


String Functions 


Function 


& 

CHAR(n) 
CODE(string) 
CONTENTS(cell) 
DISPLAY (value, format 
value or string,width) 
FIND(searchstring, 
string,startnumber) 
LEFT(string,n) 


Standard deviation of population for values 
in offset field of input range that meets 
criteria 

Sum of values in offset field of input range 
that meets criteria 

Population variance for values in offset field 
of input range that meets criteria 


Returns 


Absolute value of value 

e to the power value 

Integer of value 

Natural log, log base e, of value 

Log base 10 (common log) of value 

Remainder from the division of valuel by 
value2 

Value rounded to number of places 

Value rounded up to number of places 

Square root of value 

Value truncated to number of places 


Returns 


Arccosine of value 
Arcsine of value 
Arctangent of value 
Arctangent of point 
Cosine of value 
Value of Pi 

Sine of value 
Tangent of value 


Returns 


Concatenation of strings 

ASCII value of n 

ASCII value of first character in string 

The contents of cell as a string 

String equal to value formatted according to 
format string and displayed at width 

Character position of searchstring in string 
beginning at startnumber 

The first n characters of the string 
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LENGTH(string) 
LOWER(string) 
MID(string,startnumber,n) 


PROPER(string) 
REPEAT(string,n) 
REPLACE(originalstring, 
startnumber,n,newstring) 
RIGHT(string,n) 
STRING(x,n) 


TRIM(string) 


UPPER(string) 


Special-Purpose Functions 


(cell) 


FORMAT(cell) 
TYPE(cell) 
VALUE(string) 
WIDTH(range) 


Using Functions 


Functions 


Returns 


Length of string 

String converted to lower case 

Substring of length n beginning with the 
startnumber character position 

String converted to proper capitalization 

String repeated n times 

Removes 7 characters of originalstring 
at startnumber and inserts newstring 

Last n characters of string 

Converts x to string with n decimal 
places 

Removes excess spaces in front and end 
of string 

String converted to upper case 


Converts string representation of cell 
into cell address 

Format value of cell 

Character that represents cell type 

Numeric value of string 

Width of column(s) where range is 
located 


Enter a function just as you would any other entry. You must 
include the function, as well as any arguments and punctuation. 
When you press Return, the result of the function — date/time, 
numeric, or string — is entered in the cell. Or, with 

/Global, Formula on, the function itself displays in the cell. 


This section explains the ten categories of functions and either 
describes what they can do or gives examples of their applications. 
Notice that these functions are only updated when the spreadsheet 
is recalculated: CURADDRESS, CURCOL, CURPAGE, CURROW, 
CURSHEET, FORMAT, ISPROT, ITER, LASTCOL, LASTROW, NOW, 
RANDOM, THISCOL, THISROW, TODAY, and WIDTH. These 
functions always apply to the current sheet when executed in a 
macro (inside or outside the curly brackets): CURADDRESS, 
CURCOL, CURPAGE, CURROW, CURSHEET, LASTCOL, LASTROW. 
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Logical Functions 


Logical functions include conditional logic functions, cell type 
tests, and cell type assignment functions. The cell type functions 
can be used to test for error-causing values before performing 
calculations. 


For example, before entering a function that requires a string 
value as an argument, you can test the cell to be certain that it 
does contain a string value. Ifthe test returns True (1), you can 
enter the function. This expression shows how the logical 
function IF can be use with a cell type function before applying 
another function: 


IF(ISSTR(C1), UPPER(C1),C1) 


This formula first tests cell C1 to see if it contains a string value. If 
it does, ISSTR returns True (1) and the formula continues with the 
function UPPER to return the contents of C1 in upper case. If the 
cell does not contain a sting value, ISSTR returns False (0), and 
the formula returns the unchanged contents of C1. 


Cell Type Functions 


These functions test for value type: ISBLANK, ISDATE, ISERROR, 

ISNA, ISNUM, ISPROT, ISSTR, ISTIME, and ISVAL. They are most 
often used with a cell reference but the argument can also be an 

expression. Each function returns either True (1) or False (0). 


Cell Type Assignment Functions 


The cell type assignment functions, ERROR, NA, TRUE, and 
FALSE, place the values Error, N/A (Not Available), 1 (True), or 0 
(False) in a cell. 
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Conditional Logic Functions 


A logic function consists of a relational comparison connected by 
a logical operator: AND, EXACT, IF, NOT, and OR. Complex 
logical expressions may be formed with parentheses. 


IF(OR(Exp Aa,Exp Ab),Exp B,Exp C) 


This formula states, “If expression Aa or expression Ab is true, 
then use expression B. If Aa and Ab are both false, then use 
expression C.” 


Calendar Functions 


SuperCalc’s calendar functions let you enter a date or time, then 
reference that date or time in calculations for other cells. 


The Julian calendar used by SuperCalc ranges from March 1, 1900, 
to February 28, 2100. Days in this 200-year range are numbered 
sequentially from 1 through 73049. The integer portion of these 
sequential numbers corresponds to the date, the fractional part 
corresponds to the time. 


The calendar functions fall into two categories: Date/Time Entry 
functions and Date/Time Reference functions. 


SuperCalc uses /Format, User-define, Date, 1 as the default format 
for date entries. /Format, User-define,Date,T is the time default. 
Although expressed in numbers, a date or time does not 
constitute a numeric entry. A date or time value is a special value 
and can only be referenced by the Date/Time Reference 
functions, such as DAY(value). 


Date/time values can be used in some arithmetic operations: 
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NW You can add a numeric value to (or subtract the value from) a 
date to produce a later (or earlier) date. The number is 
assumed to represent days and the result produces a new 
date. For example: 


If cell Al has the date value 12/13/89, the formula A1 + 45 — 
produces the date value 1/27/90. 


DATE(12,25,89)+7 produces 1/ 1/90 
DATE(3,25,89)-365 produces 3/25/88 


m You can subtract one date from another. The result is 
expressed as a numeral representing the number of days 
separating the two dates. For example: 


DATE (10,31,89)-DATE(7,4,89) produces 119 


Mixing Date and Numeric Values 


Using a date value in any other arithmetic context 
produces the ERROR value (a number minus a 
date produces an ERROR). 


Date/Time Entry Functions 


You can enter a date or time into your spreadsheet using one of 
the Date/Time Entry functions: DATE, DATEVALUE, EDAT, NOW 
TIME, TIMEVALUE, or TODAY. 


) 


The DATE and EDAT functions accept numbers outside the 
normal range of dates. Such dates are converted to their valid 
counterparts if possible. If this is not possible (past 2/28/2100), 
an ERROR results. For example: 

DATE(6,60,89) is converted to 7/30/89 


DATE(15,01,89) is converted to 3/1/90 
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This lets you conveniently create dates that span logical new 
months or years. 


Date/Time Reference Functions 


SuperCalc has these Date/Time Reference functions: DAY, 
HOUR, JDATE, JTIME, MINUTE, MONTH, SECOND, YEAR, and 
WDAY. With each of these, you specify the function first, 
followed by a Julian time or date, which is typically contained in 
a cell, or a Date/Time Entry function such as TODAY. SuperCalc 
places the formula in the current cell and returns the value. If the 
referenced cell does not contain a valid DATE, the function 
produces the ERROR value. 


Special Considerations 


You can create series of dates automatically with the command 
//Data,Block. 


You can use lookup tables to convert the numeric value of the 
Date/Time Reference functions to their corresponding names. For 
example, to convert WDAY functions to the day of the week, set 
up a lookup table as follows: 


Sunday 
Monday 
Tuesday 
Wednesday 


Thursday 
Friday 
Saturday 
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Then, using the WDAY function, you can display the weekday for 
any date. For example, this expression displays the week-day for 
the current date with: 


Lookup(WDAY(B1),AA101:AA107) 


where B1 = Today, and AA101 to AA107 is the range of day 
numbers shown above. 


Financial Functions 


The SuperCalc financial functions perform a variety of 
calculations, in the following areas: 


NW Annuities, Lifetime and Periodic 
NW Onetime Investments 
E Depreciation 


Each area is discussed separately, but some common terms are 
used in the description of each of these functions: 


Rate Refers to an interest rate corresponding to a single 
period and expressed as a decimal (10% is .10 and not 
10). Divide the yearly interest rate by 12 if the period is 
monthly. 


Term Refers to the number of periods in the life of the 
investment, loan, depreciated property or other item 
being computed. Multiply the number of years by 12 if 
the period is monthly. 


Period Refers to a single period, between 1 and term. 

Payment Refers to the periodic payment made on a loan, for 
example. 

Present value Refers to the initial investment or amount borrowed. 

Future value Refers to the value of an investment after term periods. 
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These functions are similar to those performed by a hand-held 
financial calculator. The corresponding calculator function is 
described with these functions. The table below summarizes the 
input and output of each financial function. In the table, i= 
interest rate, pmt = payment, n = number of payments, pv = 


present value, and fv = future value. 


Financial Functions Table 


Function 
FV 
COMPBAL 


Solving 
For 

fv 

fv © 


i 


i 
other (i) 
other (i) 


SREE 


pmt 
pv 
pv 
other 
other 
other 
other 
other 
other 


Given 
pmt,i,n 
pv,i,n 


pmt,pv,n 
fv,pv,n 
pv,i,n,period 
pv,i,n,period 


pmt,i,pv 
i,fv,pv 
pmt,i,fv 


pv,in 

pmt,i,n 

irange 

pv,i,n,period 
pv,i,n,period 

guess, range 
cost,salvage life, period 
cost, salvage, life 
cost,salvage life, period 
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Annuities, Lifetime and Periodic 


Annuities are investments which yield periodic payments, 
especially yearly. They include mortgages, which are annuities 
from the lender’s point of view. 


An ordinary annuity requires payment at the end of each period 
while an annuity due requires payment at the beginning of each 
period. The SuperCalc annuity functions are calculated as 
ordinary annuities and assume equal payments for all periods. 


The annuity functions are all related, each one performing a 
specific calculation. There are two groups of annuity functions. 
The first group calculates over the entire life of the annuity. The 
second group calculates data for a specific term (period) within 
the annuity. 


The following spreadsheet demonstrates the use of all the annuity 
functions: ANRATE, ANTERM, PMT, PV, BALANCE, KINT, KPRIN, 
and PAIDINT. The constants in column B have been named BPV, 
BINT, BTERM and PER. The contents of cell G7 have been 

named BPMT. (Note that if you name a cell the same as a Nal 
function, such as PV, you cannot use that function.) 


The first four functions calculate over the life of the annuity. The 
second set of four functions calculate for the Kth period of the 
annuity. This example is for the second term (PER = 2). 


Functions 
Comment 


Present Value PMTCBPU,BINT,BTERM) 789.81441 
187 PER ANNUM PUCBPMT, BINT, BTERM) 90888 
(38 * 12) ANRATECBPNT , BPU, BTERN) ¿40833333 

ANTERMCBPMT,BINT,BPU) 368 


PERIOD KINT(BPV, BINT, BTERM, PER) 149 66821 
KPRINC(BPU,BINT,BTERM,PER) 48,1462 
BALANCE (BPU, BINT, BTERN,PER) 89920.8039 
PAID INT(BPU,BINT,BTERM,PER) 1499.6682 — 
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Onetime Investments 


The onetime investments functions calculate data concerning an 
investment that has not been modified since its inception, such as 
a certificate of deposit. These functions include CTERM, 
COMPBAL, and RATE. 


The following spreadsheet demonstrates the onetime investment 
functions. The constants in column B have been named SPV, 
SINT and STERM. The formulas in Column E have been named 
FCOMPBAL, FTERM and FRATE. (Note that if you name a cell the 
same as a function, such as RATE, you cannot use that function.) 


Comment Nane Data Formula in Column F 


Present Value! FCOMPBAL 1618.51 COMPBAL(SPU,SINT,STERM) 
Interest RM 5 CTERMCSINT,FCOMPBAL, SPU) 
Term RATE (FCOMPBAL , SPU, STERM) 


Investing Each Period 


The following functions calculate data for investing each period. 
These functions include FV, IRR, NPV, and TERM. There are two 
types of investments, investing a fixed amount and investing for a 
varying return. The sample spreadsheet shows how each function 
can be used. 
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Column B contains the constants named IPMT, IINT, and ITERM. 

Column E contains formulas for FV, TERM, IRR and NPV. FIRR is 
cell E13 and FFV is cell E7. The range A13:A17 contains the initial 
investment and cash flows for the function IRR. 


Investing each period 


Names in Col B i Nanes in Col E Formulas in Col E 
Fixed Amount CIPMT) 


FUCTPMT, TINT, ITERM) 
o TERMCIPMT, LINT, IFU) 


187713847 IRR(A13:A17) 
1808 NPUCUIRR,A14:A17) 


Depreciation nee" 


The depreciation functions calculate the declining value of an 
asset over time and include DDB, SLN, and SYD. They are most 
useful when used to construct depreciation schedules. For 
example: 


DDB(10000,1200,8,2) = 1875.00 
This function and its arguments uses the double-declining method 


to calculate the depreciation allowable in year 2 for a piece of 
equipment that costs $10,000, with a useful life of 8 years. 
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Index functions 


The SuperCalc index functions let you reference cells indirectly 
and/or obtain information pertaining to a cell. 


CHOOSE lets you select a value from a list. 


LOOKUP, HLOOKUP and VLOOKUP let you locate cells 
within a table based on a specified column, row, or offset. 


BEGROW, BEGCOL, ENDROW, and ENDCOL return 
perimeter row and column data on a range. 


LASTCOL and LASTROW return perimeter data for the active 
spreadsheet. 


ROWS and COLS return the number of rows and columns 
within a range. 


THISROW and THISCOL return the row and column numbers 
of the current cell. 


CURROW and CURCOL return the row and column numbers 
of the current cell. 


CURADDRESS returns the cell address (row and column 
number) of the current cell. 


CURSHEET returns the name of the current spreadsheet. 
CURPAGE returns the current spreadsheet page number. 


INDEX returns the value in the cell specified by a range, and 
offset columns and rows. 


ITER returns the current iteration count. 


The following spreadsheet demonstrates the use of some of the 
index functions. It is a portion of a loan payment table. The 
principal value, interest rate and term are in cells A24 to A26 
respectively. 
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Column A contains formulas that calculate the monthly interest for 
each period. The use of TROW-7 in the KINT formulas provides 
incremental months based upon the row number (row 8 becomes 
month 1). 


Column B also uses the TROW function. This formula uses the 
MOD function to “recycle” every third period, thus providing 
accumulated quarterly interest. 


Column C uses the INDEX function to gather the quarterly interest 
into contiguous cells. 


Loan Payment Table, w 
INDEX is used to "gather" quarterly interest into contiguous cells 
] (AQI=B8:B19) 
KINTCSFPU, SINT, SRTERM IF (HOD (TROW+1,3),B7+AB,AB) INDEX(SAQI,A, (TROW- 
| TROW-7) BROW (SAQ I )*3+2) 
(Monthly Interest) C(Accunu lated (Gathered 
Quarterly Interest) Quarterly Interest) 
506.68 588 . 68 1,499.57 
499.86 999 .86 1,498 26 
499.71 1,999.57 1,496 .98 
499,57 499,57 1,495.51 
499,42 998,99 
499,27 1,498.26 
499,12 499,12 
498.97 9398.09 
1,496.98 
498.66 58,888 ,8B 
997,16 
1,495,51 


Statistical Functions 


The SuperCalc statistical functions perform calculations on a list of 
values. For example, AVG(7,8,9) computes the arithmetic mean 
of the three arguments following it — 8. The statistical functions 
are AVERAGE, COUNT, MAX, MIN, RANDOM, STD, SUM, and 
VAR. These rules apply: 


m Valid arguments can be numbers, cell addresses, ranges, and 
range names. 
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m A list may contain more than one argument. Each argument 
must be separated by a comma. 


For example, arguments for the following function are 
(respectively) a range, a cell, a named range, and the number 
Pay 


AVG(A1:A10,A15,SALES,23) 


Æ Blank cells that are referenced as part of an argument are 
ignored. 


//Data, Analysis, Distribution and //Data, Analysis, Regression are 
frequently used with the statistical functions. 


Data Management Statistical Functions 


The data management statistical functions perform statistical 
calculations on a specified field of a database according to a 
specified criterion range. They are DAVG, DCOUNT, DMAX, 
DMIN, DSTD, DSUM, and DVAR. These functions perform the 
same type of calculations as their non-database statistical function 
counterparts. The difference between the two types of functions 
is that the non-database statistical functions require you to list the 
range of cells as part of the argument while the data management 
statistical functions accept a criterion argument to calculate only 
selective records with a range. 


Before you can use the data management statistical functions you 
must set up a database (see //Data in Chapter 2). 


Each data management statistical function accepts three 
arguments: 


= = Input — The input range includes the entire database that 
you want to scan including all the records and their field 
names. Note that the input range must be entered as an 
argument for each function and is not the same as the 
//Data, Input command. 
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m Offset — This argument specifies the number of columns to 


the right of the leftmost column in the input range that 
contains the field on which you wish to calculate. This 
argument is zero based; that is, the leftmost column is field 0, 
the second column is field 1, the third column is field 2, etc. 


Criterion — The criterion range contains information about 
which selected records from the database you want to use in 
the calculations. The first row of the range usually contains 
the names of the fields from the database, with the criteria 
directly below the field name. For more information on how 
to enter criteria, see //Data in this manual. Note that the 
criterion range must be entered as an argument for each 
function and is not the same as the //Data, Criterion 
command. 


Although the input range and criterion range for the database 
statistical functions are not dependent upon the //Data, Input and 
//Data, Criterion settings, the formats of the database fields and 
criterion range still must correspond to that of the database. That 
is, the first row of the input range must contain field names. Any 
criterion range field name used must match exactly one of the 
input range names. 


The following expense report spreadsheet is set up as a database, 
and the examples in the function definition section all refer to it. 


The input range has been named INPUT and is defined as A3:F15. 


The criterion ranges have each been named (using /Name), and 
those names appear to the right of their corresponding range. 


Examples in the function definitions for each data management 
statistical function refer to these ranges by name. 


The range named MAY, H4:H5, contains the field name Date 
and the formula criterion A4<=DATE(5,31,88). Use of this 
range as the criterion argument in a database function will 
include in the calculations only those records in the input 
range which contain a date of 5/31/88 or earlier in the field 
Date. 
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m The range named AUSTIN, H7:H8, contains the field name 
City and the criteria Austin. Use of this range as the criterion 
argument in a database function will include in the 
calculations only those records in the input range which 
contain Austin in the field City. 


m The range named HOUSTON, H10:H11, contains the field 
name City and criteria Houston. Use of this range as the 
criterion argument in a database function will include in the 
calculations only those records in the input range which 
contain Houston in the field City. 


m The range named TEXAS, H13:H16, contains the field name 
City and the criteria Dallas, Austin, and Houston. Use of this 
range as the criterion argument in a database function will 
include in the calculations any records in the input range 
which contain either Dallas, Austin, or Houston in the field 
City. 


Note that the column width for B is 2, to separate Date and City 
data for readability. 


Names of 
Ranges 


Criterion 
Ranges 


Expense 


Date 

5/25/88 
5/26/88 
5/27/88 
5/28/88 
5/29/88 
5/38/88 


City Mea ls Gas 
Shreveport .58 14. 
Dallas .65 ZZi: 56. 
Dallas . B6 T3: 56. 
Dallas .74 18. 56. 
Austin .83 6. 54. 
Austin a < 5 54. 


Hotel 
Date 
1 


City 
Austin 


5/31/88 
64 1/88 
6/ 2/88 
6” 3/88 
67 4/88 
6/ 5/88 


Houston 
Houston 
Houston 
Houston 
Austin 
Shreveport 


.87 
35 
.54 
.68 
39 
45 


22. 
28. 
G 
15. 
13. 
F. 


72 
72 
72 
72 
45 


54. 


ARES: 
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Arithmetic Functions 


SuperCalc’s arithmetic functions perform a variety of calculations. 
The arithmetic functions are ABS, EXP, INT, LN, LOG10, MOD, 
ROUND, and SQRT. With these functions: 


W An argument can be a number, cell address, range name for a 
single cell, formula or another function. 


NH Each function returns a numeric value. For example: 


If cell B3 contains the numeric value 7654.321, the 
following will result: 

ROUND(B3,2) = 7654.32 

ROUNDUP(B3,2) = 7654.33 


Trigonometric Functions 


The SuperCalc trigonometric functions perform calculations on 
angles. These functions include ACOS, ASIN, ATAN, ATANZ2, 
COS, PI, SIN, and TAN. For these functions: 


mE An argument can be a number, a cell address, a range name 
for a single cell, a formula, or another function. 


m For sine, cosine, and tangent, the angle you enter must be in 
radians. Multiply the number of degrees by PI, 180 to convert 
to radians. 


m For arc sine, arc cosine, and the arc tangent functions, the 


computed angle is in radians. Multiply the number of radians 
by 180/PI to convert to degrees. 
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m Trigonometric quadrants are defined according to their 
position on an X-Y grid. The following illustration shows 
how the quadrants are defined: 


String Functions 


Strings are any series of characters including letters, numbers, and 
special characters. String functions calculate with strings or 
produce string value results. The string functions include &, 
CHAR, CODE, CONTENTS, DISPLAY, FIND, LEFT, LENGTH, 
LOWER, MID, PROPER, REPEAT, REPLACE, RIGHT, STRING, 
TRIM, UPPER. 


When entering string function arguments, note the following: 


E Actual string arguments must be enclosed within quotation 
marks (“ ”). 


Example: 
LENGTH(CMississippi”) = 11 


Formulas and Functions 3-37 


Functions 


NH Strings may be referred to by cell address or range name. 


Example: 


If cell C5 contains the text MISSISSIPPI, then 
LENGTH(C5) = 11 


m The number of characters in one string is limited to 240. 
Character positions always begin at 0, therefore position 
numbers can be from 0 to 239. 


Example: 


In the string “Mississippi”, the length is 11 characters. 
M is at position 0, and the final “i” is at position 10. 


m If an argument for a string function is a cell reference which 
contains repeating text, only the first occurrence of the 
repeating text is used by the function. 


Example: 
Cell A1 contains the repeating text “Hi Hi Hi Hi..”. 


Cell A2 contains the repeating text “there! there! 
there! there!...?. 


A1&A2 = Hi there! 
UPPER(A1) = HI 


m If an argument for a string function is a cell reference which 
contains a numeric value, the result will be a null string. 


Example: 
Cell A1 contains the numeric value 54000, and 
Cell A2 contains the text “alone”. 
A1&A2 = “alone” 
UPPER(A1) = “ ” 
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Special Purpose Functions 


The special purpose functions are used to perform assorted tasks. 
For instance, you can determine the width of a range or column, 
the format value of a cell, or the cell type. Included in this 
category are the functions @, FORMAT, TYPE, VALUE, and 
WIDTH. 


For example, if cell A1 is formatted to a width of 8, then: 
WIDTH(A1) = 8 


Function Definitions 


The following sections list each function alphabetically. For 
information on functions by category and how to use categories 
of functions, see earlier sections in this chapter. 


& 


This function concatenates strings. When used with direct entry of 
a string rather than a cell reference, you must begin the entry with 
the symbol + and enclose the strings to be concatenated within 
quotes. 


Example: 
+“spring’&“time” = springtime 


Or, if Al contains spring and B1 contains time, then A1&B1 
= springtime 


@(cell) 


Converts the string representation of a cell contained in cell into a 
cell address and returns the contents of the cell at that cell 
address. This can be used for indirect cell addressing in formulas 
and macros. 
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Example: 


If cell A1 contains the string F2 (entered as "F2), and cell F2 
contains the value 45, then: 


@(Al1) = 45 


Use of the @ function in a formula breaks natural order 
calculations. 


ABS(value) 


Returns the absolute value of the argument. 

NW Equivalent to the value itself if positive. 

NW Equivalent to the value without its negative sign if negative. 
NH Equivalent to zero if the expression is zero. 


Example: 
ABS(-237) = 237 


ACOS(value) 


Returns the radian angle whose cosine is value. 
Value range: -1to 1 

Return range: O to PI 

Quadrant angle: I or II 


Example: 
ACOS(C5) = 1.0471975512 (radians) 
ACOS(.5)*180/PI = 60 (degrees) 
ACOS(2) = ERROR (value out of range) 
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ADDRESS(range) 


Returns a string which is the cell address of the upper left corner 
of range. The cell address will be formatted as an absolute cell 
reference. 


Example: 


If the name Assets refers to the range A5 through 125, 
ADDRESS(assets) = $A$5 


AND(valuel,value2) 


A logical AND function has a value of TRUE (numeric value of 1) 
if both value 1 and value 2 are true (any value other than zero). 
If either value is false (the value of zero), the AND function is 
FALSE (numeric value of 0). 


AND (True,True) = True 

AND(True,False) = False 
AND (False,True) = False 
AND (False,False) = False 


Example: 


AND(H6=5,B3=8) returns the value of 1 if both conditions 
are true. Returns the value of 0 if either condition is false. 


ANRATE(payment, present value,term) 


This function computes the periodic interest rate reflected by an 

annuity with an initial principal balance of present value, paid in 

term equal installments of payment. ANRATE corresponds to the 
“Solve for % i” function of a financial calculator. 


ANRATE is calculated iteratively such that: 
PV(PMT,INT,N)=PV 
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Example: 
What is the yearly interest rate on a loan of $90,000 with 
360 monthly payments of $789? 
ANRATE(789,90000,360) =.00833333 


.0083333 (monthly) X 12 = .0999996 
(approximately 10% interest per year) 


ANTERM(payment,rate, present value) 


This function computes the number of periods needed to reduce 
present value to zero, at payment per period for a given interest 
rate. ANTERM corresponds to the “Solve for N (number of 
periods)” function of a financial calculator. 


—Injil _py+ DE 
PMT 


In (1 + INT) 


— 


Example: 


How long does it take to pay back a loan of $10,000 at 10% 
annual interest with payments of $100 per month? 


ANTERM(100,.10/12,10000) = 215.91 


215.91 (months) / 12 = 17.99 
(approximately 18 years) 


ASIN(value) 


Returns the radian angle whose sine is value. 
Value range: -lto 1 
Return range: -PI/2to PI/2 


Quadrant Angle: Ior IV 
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Example: 
ASING5) = .523598775598 (radians) 
ASIN(.5)*180/PI = 30 (degrees) 
ASIN(2) = ERROR (value out of range) 


ATAN(value) 


Returns the radian angle whose tangent is value. 
Value range: Any number 
Return range: -PI/2 to PI/2 


Quadrant angle: I or IV 


Example: 
ATAN() = 0 (radians) 
ATAN(.57735026919)*180/PI = 30 (degrees) 


ATAN2(x,y) 

Returns the radian angle whose tangent is x/y. 
x and y ranges: Any value 

Return range: -PI to PI 

Quadrant angle: I, Il, Ill, IV 


ATAN2 computes the four quadrant arc tangent of an angle. You 
specify the angle with its X and Y coordinates. This is opposed to 
ATAN, which computes the two quadrant arc tangent, and for 
which you enter the tangent ratio. 
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The following summarizes the returned value: 


ATAN2(x,y) 
When x is When yis returns QUADRANT 
positive positive O to PI/2 I 
negative positive PI/2 to PI II 
negative negative -PI to -PI/2 il 
positive negative -PI/2 to 0 IV 
AVERAGE(list) 
AVG(list) 
AV(iist) 


Returns the average (mean) of the range given. This function is 
equivalent to the SUM of the list divided by the number of items 
on the list. If no formula cell with a numeric value exists in /ist, 
this function returns ERROR. 


Example: 


AVERAGE(10,15,20) = 15 


BALANCE(present value,rate,term, period) 


This function computes the remaining principal after period 
payments. BALANCE corresponds to the “Solve for principal after 
K periods” function of a financial calculator. 


The formula is: 


‘ 1 I period = 
PV(1 + INT)" — PMT(PV,INT,TERM)* [A >) 


INT 


Example: 


What is the balance remaining after 2 months on a loan of 
$90,000 at 10% annual interest with a term of 360 months? 


BALANCE(90000,.1/12,360,2) = $89,920.04 
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BEGCOL(range) 
BCOL(range) 


BEGCOL returns the column number of the upper-left cell in 
range. 


Example: 
BEGCOL(E4:F10) = 5 


Column E, the beginning column in the range, is the fifth 
column 


BEGROW(range) 
BROW(range) 


BEGROW returns the row number of the upper-left cell in range. 


Example: 
BEGROW(E4:F10) = 4 


Row 4 is the fourth row. 


CCOL 
See CURCOL. 


CHAR(n) 


Converts the numeric value n to an ASCII character. This function 


can be used to input control characters into the spreadsheet. If 
the value of n is greater than 255 or less than 0, CHAR(n) returns 
ERROR. 
Example: 

CHAR(65) = A 

65 is the ASCII equivalent of the letter A. 
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CHOOSE(x,v0,v1,...,vn) 


CHOOSE returns the xth value from the list of values v0,v1,...,vn. 
The first list item is value 0. Thus, when x is 1, CHOOSE returns 
the second item in the list, v1. 


E x must be between 0 and n. 

m You must enter a value for x and at least one value for the 
list, vO. This function requires x + 7 number of values or the 
formula returns ERROR. 

m There is no upper limit to the number of values in the list, 
except that the formula length limitation of 240 characters per 
formula in a cell still applies. 

E Values can be any type: Text, numeric, string, date values, 
time values, and cell references. 

m If the value of x references a blank cell, x is 0. If x is a non- 
integer, SuperCalc first converts it to an integer, dropping any 
decimal places. 

Example: 


CHOOSE(1,“Buy”, “Sell” ,“Trade”) = Sell 
“Sell” is the second item, occupying the v1 position. 
CHOOSE(C1,A1,A2,A3,A4) 


This formula returns the value in cell Al when C1 is 0 and 
the value in A4 when Cl is 3. 


CHOOSE(SWITCH,FIRST,MIDDLE,LAST) 


This formula uses named ranges to refer to cells. It returns 
the value in FIRST when SWITCH is 0, the value in 
MIDDLE when SWITCH is 1 and the value in LAST when 
SWITCH is 2. 


3-46 SuperCalc Reference Manual 


Functions 


CODE(string) 


Returns the ASCII equivalent of the first character of the string. 


Example: 
CODE(“Alpha”) = 65 
65 is the ASCII equivalent of the letter A. 


COLCHARS(value) 


Takes value and returns the equivalent column string, A through 
IU. 


Example: 
COLCHARS(3) = C 


If A4 contains 3 and A5 contains A4+1, then 
COLCHARS(AS) = D. 


COLS(range) 

COLS returns the number of columns in range. COLS is useful for 
determining the number of columns in a named range. 

Example: 


COLS(C3:F10) = 4 means there are four columns in the 
range: C,D,E, and F. 


COLS(QUARTER) = 4 when the range C3:F10 (same as 
above) has been named QUARTER. 


CONTENTS(cell) 


Returns the contents of a cell as a string. 


Example: 
If B5 contains the formula SUM(A1:B3), then 
CONTENTS(B5) = “SUM(A1:B3)” 
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COMPBAL(present value,rate,term) 


This function computes the final balance in an account started 
with an initial investment of present value, where interest rate is 
compounded periodically for term periods. 


The formula is: 
PV * (1 + INT)TERM 


Example: 


What is the balance after 5 years on an initial investment of 
$1,000.00 at an annual interest rate of 10% compounded 
periodically? 


COMPBAL(1000,.10,5) = $1,610.51 


COS(value) 


Returns the cosine of the radian angle. 


Return range: -1 to 1 
Example: 
COS(PD = -1 (cosine of PI radians) 
COS(60*PI/180) = .5 (cosine of 60 degrees) 
COUNT(list) 


Returns the number of cells which result in a numeric value in 
list. If list contains no cell with a numeric value, this function 
returns Zero. 


Example: 


COUNT will count the following cells: 
A1 = SUM(B1:D6) 

A3 = 6200 

A4 = FINDC“He”,“Hello”,0) 
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Count will not count the following cells: 
A2 = DVAL(67050) 
A5 = This is a string. 


With the above cell contents, 


COUNT(A1:A5) = 3 


CROW 
see CURROW 


CTERM(rate,future value,present value) 


This function computes the number of periods (term) required for 
an initial investment of present value to grow to future value at 
interest rate per period. 


In(fv/pv) 
In(1 + int) 


where fv = future value 
Pv = present value 
int = periodic interest rate 
In = natural logarithm 


Example: 


How many years will it take to double an investment from 
$5,000 to $10,000 at a 14% interest rate? 


CTERM(.14/12,10000,5000) = 59.76 


59.76 months /12 = 4.98 
(approximately 5 years) 


CURADDRESS 


The cell address — column and row number — of the current 
cell. If the cursor is in the third column and second row, 
CURADDRESS will return $C$2. 
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CURCOL 
CCOL 


Returns the column number of the current cell. 


Example: 


If the current cell is C5, CURCOL returns 3 for column C. 


CURPAGE 


Returns the current spreadsheet page number. 


CURROW 
CROW 


Returns the row number of the current cell. 


Example: 


If the current cell is C5, CURROW returns 5. 


CURSHEET 


Returns the current spreadsheet name. 


Example: 


CURSHEET = TEMP1 
(before saving a new spreadsheet) 


DATE(mm,dd,yy) 
DATE(mwm,dd,yyyy) 
DAT(mm,dd, yy) 
DAT(mm,dd,yyyy) 


Enter the month, day, and year in that order, separated by the 
currently defined operand separator (such as a comma). The year 
may be entered either as a two-digit or four-digit number. 
SuperCalc assumes two-digit years are twentieth century and adds 
1900 to the entry. To enter a twenty-first century date, use four 
digits. 
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You may enter single digit values without a leading 0. For 
example, the date for February 8, 1988 could be entered as: 


DATE(2,8,88) 


For the default column width (9), SuperCalc displays the date 
showing only the last two digits of the year, even if you enter a 
four-digit value. There is no on-screen distinction between 
centuries, even though SuperCalc keeps track of them internally. 
The column width must be at least 11 to see all four digits. Then, 
you will see a four-digit year, even if you enter it as a two-digit 
number. 


Only those dates within the 200-year range of the SuperCalc 
calendar are accepted. If you attempt to enter a date outside that 
range, ERROR results. 


DATEVALUE(date value or string,fstring) 


Converts date value, string, or the integral portion of a Julian 
date/time into a date-formatted value. If you enter a value, it 
must be a number between 1 and 73049. DATEVALUE is the 
inverse of JDATE. You can also use another Date/Time Entry 
function as an argument, for example DATEVALUE(NOW). 


If you enter a date string, you can specify its format with fstring. 
Fstring is made up of the characters D, M, and Y and specifies the 
pattern of the date format of string. Fstring is an optional 
argument. If you don’t include it, SuperCalc will attempt to 
interpret string. 


If string includes a character month (e.g. Jan or January) preceded 
by a number, SuperCalc will assume fstring "dm" or "dmy", 
depending on whether the month is also followed by a number. 
If a character month isn’t preceded by a number but is followed 
by one number, SuperCalc assumes "my"; if two numbers follow, 
then "mdy." 
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For digit months, the order is determined by the separator 
character. If slash (/), SuperCalc assumes "mdy" or "md"; if 
hyphen (-), then "ymd"; if period (.), then "dm" or "dmy." 
Otherwise, you must include fstring. 


Regardless of the date string you enter, the result of DATEVALUE 

is formatted according to the date/time format currently in effect 

for that cell. 

Example: 
DATEVALUE(‘January 13, 1950”,“MDY”) = 1/13/50 
DATEVALUE(‘13 January, 1950”,“DMY”) = 13/1/50 
DATEVALUE(“74/01/01”,“YMD”) = 1/ 1/74 
DATEVALUE(1) = 3/1/00 (March 1, 1900) 
DATEVALUE(73049) = 2/28/00 (February 28, 2100) 
DATEVALUE(1.5) = 3/1/00 (March 1, 1900, 12:00:00) 


DAVG(input,offset,criterion) 
DAV(input,offset,criterion) 


Calculates the mean (average) of the values in the offset column 
of the input range that meet the criteria in the criterion range. 
Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DAVG(INPUT,3, TEXAS) = 34.05 


$34.05 is the average daily meal expense for all the cities in 
Texas. 


DAVG(INPUT,4,MAY) = 16.29 


$16.29 is the average daily gas expense for the dates in 
May. 
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DAY(date value) 
Returns the number of the day of the month of date value or the 
integral portion of a Julian date/time. 
Example: 
Assume cell A3 contains the system date 8/16/88: 
DAY(A3) or DAY(TODAY) returns 16. 
DAY(32311) returns 16, with DVALG2311) = 8/16/88. 


DCOUNT(input,offset,criterion) 


Returns the number of nonblank, nonzero cells in the offset 
column of the input range that meet the criteria in the criterion 
range. 


Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DCOUNTUNPUT,2, TEXAS) = 10 
10 days were spent in Texas. 
DCOUNTUNPUT,2,MAY) = 7 


7 days were in May. 


DDB(cost,salvage,life, period) 


Returns the depreciation allowance on an asset for a specified 
period of time using the double-declining balance method. 


The double-declining balance method accelerates the amount of 
depreciation allowable in early years. Depreciation stops when 
the present value reaches the salvage value. SuperCalc adjusts the 
depreciation (when necessary) to ensure that the total 
depreciation is equal to the cost minus the salvage value. 


Formulas and Functions 3—53 


Functions 


The formula for DDB is: 


(bv* 2) 
n 


where bv = book value in that period 
n = life of the asset 


Example: 


The following spreadsheet calculates the double-declining 
balance depreciation schedule for a piece of equipment 
that costs $10,000. The useful life of the machine is 8 years 
with a salvage value at that time of $1200. 


ouble Declining Balance 


Names for Variables (Column B) 


Formulas in Column B 


DDB (COST, SALVAGE , LIFE,A11) 

1875.80 DDBCCOST, SALVAGE ,LIFE,A12) 
1496.25 DDBCOOST, SALVAGE ,LIFE,A13) 
1854.69 DDBC(COST, SALVAGE, LIFE ,A14) 
791,82 DDBCCOST, SALVAGE, LIFE,A15) 

593.26 DDBCCOST, SALVAGE LIFE, A16) 

444.95 DDBCCOST,SALUAGE ;LIFEsA1?) 

134.84 DDBCCOST, SALVAGE, LIFE,A18) 


SUM(B11-B18) 


This spreadsheet uses named ranges for the COST, SALVAGE, and 
LIFE variables. The names display next to the variables. Likewise, 
the formulas using DDB are displayed as text next to the cells that 
actually contain them. 
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DISPLAY(value,format string,width) 


Returns a string equal to the specified value, formatted according 
to the format string, and displayed at the specified width. 


The format can be either the string returned by the FORMAT 
function, or a string that contains a format descriptor. The format 
string descriptors are: 


L, C, or R for number justification 

“J” “$” “E” *G”, *” “H”, of “Un tor number format Uwhere’ #7 is 
User-defined number format 1 through 8) 

D1, D2, ...,D8 for date format 

TL, TC, TR for Text justification 


See /Format in Chapter 2 for more information on these values. 


Example: 


DISPLAY(3200,“E”,9) = 3.2E3 in a column 9 characters 
wide. 


DISPLAY(3200,“$”,15) = 3200.00 in a column 15 characters 
wide. 


DMAX(input,offset,criterion) 

Returns the largest value in the offset column of the input range 
that meets the criteria in the criterion range. 

Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DMAX(INPUT,3, HOUSTON) = 41.60 
$41.60 was the most spent for meals in Houston. 
DMAX(INPUT,3,MAY) = 35.70 


$35.70 was the most spent for meals in May. 


Formulas and Functions 3—55 


Functions 


DMIN(input,offset,criterion) 

Returns the smallest value in the offset column of the input range 
that meets the criteria in the criterion range. 

Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DMINUNPUT, 3, HOUSTON) = 33.54 
$33.54 was the least spent for meals in Houston. 
DMINUNPUT,3,MAY) = 4.50 


$4.50 was the least spent for meals in May. 


DSTD(Cnput,offset,criterion) 


Computes the population standard deviation for values in the 
offset column of the input range that meet the criteria in the 
criterion range. 


Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DSTDUNPUT,3, TEXAS) = 3.63 


The standard deviation for daily meal expense in Texas is 


$3.63. 
DSTDUNPUT,5,HOUSTON) = 0 


The standard deviation for daily hotel expense in Houston 
is O (the hotel expense was the same for each day in 
Houston). 
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DSUM(in put,offset,criterion) 

Computes the sum of the values in the offset column of the input 
range that meet the criteria in the criterion range. 

Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DSUMCNPUT,4,HOUSTON) = 63.17 

The total expense for gas in Houston is $63.17. 
DSUM(INPUT,4,MAY) = 114.05 

The total expense for gas in May is $114.05. 


DVAL(value) 


Returns the date and time of the value specified. The value must 
be a number between 1 and 73049. DVAL is the inverse of 
JDATE. 


Example: 
DVAL(1) = 3/1/00 (March 1, 1900) 


DVAL(73049) = 2/28/00 (February 28, 2100) 
DVAL(1.5) = 3/1/00 (March 1, 1900, 12:00:00) 


DVAR(input,offset,criterion) 


Computes the population variance for values in the offset column 
of the input range that meet the criteria in the criterion range. 


Variance is a measure of the degree to which individual values in 
the list vary from the mean (average) of all the values in the list. 
A high variance means that the values vary greatly, while a low 
variance means that the values are similar. When all values in the 
list are identical, the variance is zero. Variance is the square of 
the standard deviation (see the STD function). 
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Example: 


Each of these examples refer to the spreadsheet that 
appears in the section Using Functions, Database 
Management Statistical Functions, in this chapter. 


DVARUNPUT,3,TEXAS) = 13.19 
The variance for daily meal expense in Texas is $13.19. 
DVARCUNPUT,5,HOUSTON) = 0 


The variance for daily hotel expense in Houston is 0 (the 
hotel expense was the same for each day in Houston). 


ECOL(range) 
See ENDCOL(range). 


EDAT(dd,mm, yy) 
EDAT(dd,mm,yyyy) 


The EDAT function is for European date format entry. In all other 
respects it is the same as the DATE function. Note that the date 
displays the same regardless of which date entry function is used. 
For example, EDAT(8,2,88) and DATE(2,8,88) both display as 
2/8/88. 


You may enter single digit values without a leading 0. For 
example, the date for February 8,. 1988 could be entered as: 


EDAT(8,2,88) 


For the default column width (9), SuperCalc displays the date 
showing only the last two digits of the year, even if you enter a 
four-digit value. There is no on-screen distinction between 
centuries, even though SuperCalc keeps track of them internally. 
The column width must be at least 11 to see all four digits. Then, 
you will see a four-digit year, even if you enter it as a two-digit 
number. 
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Only those dates within the 200-year range of the SuperCalc 
calendar are accepted. If you attempt to enter a date outside that 
range, ERROR results. 


ENDCOL(range) 
ECOL(range) 


Returns the column number of the lower right cell of the range. 


Example: 


ENDCOL(E4:G10) returns 7 
(G is the seventh column) 


ENDROW(range) 
EROW(range) 


Returns the row number of the lower right cell of the range. 


Example: 


ENDROW(E4:G10) returns 10 
(the row number of G10) 


ERROR 
ERR 


SuperCalc displays ERROR in a cell that returns a value that 
cannot be calculated. You can enter the value ERROR directly 
into a cell. 


EXACT(string1,string2) 


Returns 1 (True) if string1 and string2 match exactly. Returns 0 
(False) if not. This is a case sensitive comparison. 


For a case insensitive search, use 
EXACT(LOWER(string1), LOWER(string2)). 
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Example: 


If C1 contains “Hello” and D5 contains “hello” then 
EXACT(c1,d5) = 0. 


“Hello” and “hello” do not match exactly because of 
capitalization and therefore the function returns 0 (False). 


EXACT(LOWER(C1), LOWER(D5)) = 1 (True) 


EXP(value) 


This function raises the number e exponentially to the value. The 
value of e is approximately 2.71828182846. 


Use the function EXP(1) to incorporate the value e into a formula. 
EXP is the inverse of LN. 


Input range: -127.9999999999999 to 127.9999999999999 


Example: 
EXP(2) = 7.38905609893 = (eA2) 
LNGEXP(2)) = 2 


FALSE 


Enters the value 0 (False) directly in a cell. 


FIND(searchstring,string,startnumber) 


Searches for searchstring in string beginning at the character 
startnumber, returns the position of the first character of 
searchstring counting from the first character in string (position 
0). FIND performs a case-sensitive search and returns ERROR if 
no match is found. 


For a case-insensitive search, use: 


FIND(LOWEK(string1), LOWER(string2),startnumber). 
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Example: 

FINDCbig”,“The big one”,3) = 4 
With 3 as startnumber, the search begins at the space between e 
and b, and “big” starts at 4 (counting from "T" as 0). FIND locates 


the first occurrence of searchstring. Changing startnumber lets 
you search for several occurrences in a long string. 


Startnumber is optional. If you don’t enter startnumber, the 
search starts at the beginning of string. 


FORMAT(cell) 


Returns a string which indicates the current Entry level format in 
effect for cell. The format string is in the form “jnnDdTjP”. 


Blanks in the string indicate default values, i.e. formatting at a 
higher level. 


j = L, C, R or blank for number justification 

nn =" al " - " pe " G", " mt: " y". "Un" or " " for number format 
Dd = D1, D2, ...,D8 or " "for date format 

Tj = TL, TC, TR or " " for Text justification 

p =P or" " for cell protection 


See /Format in Chapter 2 for more information on these values. 


Example: 
FORMAT(B4) ="L$ P" 


This string indicates “Left justified number in dollar format, 
with cell protection.” 


Example: 
FORMAT(D6) =" TC" 


Indicates “Center justified text without cell protection.” 
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FV(payment,rate,term) 


Computes the future value of equal payments of the simple 
ordinary annuity at rate for term periods. FV corresponds to the 
“Solve for FV” function of a financial calculator. 


The formula used is: 


(1 +int)"-1 
PO A 
int 


where pmt = periodic payment 
int = periodic interest rate 
n = number of periods 


Example: 


The value at the end of 20 years of $1000 invested at the 
end of each year at a 14% annual interest rate is computed 
in the following screen: 


ÅÅ 


1808 . 48 


FV(1000,.14,20) = 91024.93 
FV(B2,B3,B4) = 91024.93 


Thus, the value of the investment at the end of 20 years is 
$91,024.93. 
For an annuity due, use the formula: 
FV(payment,interest,period)*(1 + interest) 
Using the figures in the above example: 


FV(1000,.14,20) * (1 + .14) = 103,768.42 
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HLOOKUP(x, range,row offset) 
HLU(x,range,row offset) 


Returns the contents of the cell in the horizontal table specified by 
range, beneath column «x, in the row defined by row offset 


The first row of a horizontal table defined by range is the index 
row. Values in the index row must be in ascending order for 
HLOOKUP to work properly. HLOOKUP compares the value of x 
with each value in the index row, beginning with the upper-left of 
the range and moving right. First, it locates the column that 
contains the largest numeric, date, or string value that is less than 
or equal to x. Then, it “looks up” the value in the row that is row 
offset rows down from the index row. (Note that this is not the 
row number). 


m When row offset is positive, HLOOKUP looks down the row. 


m When row offset is negative, HLOOKUP returns ERROR. 


m When row offset is zero, HLOOKUP returns the value of the 
index row. Note that this is useful for quick rounding of lot 
numbers. For example, if the index row contains decade 
years (1950, 1960, 1970, 1980) then HLOOKUP can be used to 
return the decade of any year within the range. That is, 
HLOOKUP(1976,range,0) returns 1970. 
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Example: 


The examples are based on this Census data. The range 
A3:E8 has been named CENSUS. 


192498 
18248 


an Francisco 614 


HLOOKUP(1970,CENSUS,2) = 160000 (exact match) 
HLOOKUP(1973,CENSUS,2) = 160000 (rounded match) 
HLOOKUP(1985,CENSUS,4) = 1800 (largest value for x) 
HLOOKUP(1945,CENSUS,2) = 0 (x is too small) 
HLOOKUP(1974,CENSUS,0) = 1970 (rounded by decade) 


HOUR(time value) 


Returns the hour corresponding to the hour portion of time value 
or the fractional part of a Julian date/time. 
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Example: 
With Time set to 24br, 


HOURG1423.5) = 12 
(5 X 24 = 12) 


HOUR(TIME(14,23,15)) = 14 
With Time set to 12br, 


HOUR(32312.5) = 12 
(5 X 24 = 12) 


HOUR(TIME(14,23,15)) = 2 


HOUR(12) = 0 
(no fractional part) 


IF(expression,value1,value2) 


Enters valuel into the cell if expression is true, or value2 if 
expression is false. 


An expression in an IF function must evaluate properly to a value 
in order for the IF function to be valid. That is, the expression 
must not result in a formula ERROR. 

If value2 is omitted and the expression is false the result is zero. 


IF functions are easy to read: 


If expression is true, then use valuel. 
If expression is false, then use value2. 


In other words: If expression, then value1, otherwise, value2. 
Example: 


IF(A1=5000,10,5) = 5 


A1 contains the value 4000, the expression is false and the 
formula returns the value 5. 
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Now, suppose that you need to evaluate two IF functions at the 
same time. Consider this example: 
IF(A1=5000,5,IF(A1=4000,25,0)) = 25 


Notice that the IF function still reads Jf expression, then 
valuel, otherwise value2. It just happens that value2 is 
another IF function. 


The expression in the first IF function, A1=5000, is false so 
control moves to value2 of that function. In value2 (the 
second IF function) the expression (A1=4000) is true so the 
formula returns 25. 


Value1 or value2 can be a formula or another IF function. You 
can continue to build your formula up to 240 characters. 


Note 


There must always be as many right parentheses 
as there are left. 


IF-AND Combinations 


IF-AND combinations look like this: 
IF(AND(Exp Aa,Exp Ab),Exp B,Exp C) 
They read as follows: 
If expressions Aa and Ab are both true, then use expression 


B. If either expression Aa or Ab is false, then use 
expression C. 
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Example: 
IF(AND(A1<500,A1>0),5,0) 


This formula returns 5 if Al contains any value between 0 
and 500. The functions in Expression Aa and Ab are both 
true and so the AND function returns true.. 


The formula returns 0 if Al contains 500, since the AND 
function returns false. 


IF-OR Combinations 


IF-OR combinations look like this: 
IF(OR(Exp Aa,Exp Ab),Exp B,Exp C) 
They read as follows: 


If either Aa or Ab are true, then use Expression B. If Aa and 
Ab are both false, then use Expression C. 


Example: 
IF(OR(A1=500,A1=400),5,0) 


The formula returns 5 if only one of the expressions, 
A1=500 or A1=400, is true. 


The formula returns 0 if Al does not contain 500 and does 
not contain 400. 


INDEX(range,column offset,row offset) 


Returns the value of the cell in range at column offset and row 


offset. 


The first column in range is 0 and the top row in range is 0. 


m SuperCalc uses the integer part (if necessary) of positive 
numeric values for the offsets. 


m Negative offset argument(s) returns ERROR. 
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m Offset(s) outside of the range returns ERROR. 


Example: 
Refer to the Census spreadsheet under HLOOKUP. 
INDEX(CENSUS,2,0) = 1960 =e 
INDEX(CENSUS,0,3) = California 


INT(value) 
Returns the integer of the value given. The returned value is not 
rounded. 
Example: 
INT(2.5832) = 2 
INT(-35.42) = -35 


IRR(guess,row/col range) 
The Internal Rate of Return is the discount rate such that the NPV mee 
(net present value) of the cash flow is zero. 
guess The initial value to use as the discount rate. 
This is an optional parameter. If you do not 
specify an initial value for the discount rate, 
the program assumes a default value of 0.1. 
range A range where the first element of the range 
is the initial investment (generally a negative 
value) and the remaining entries are the cash 
flows (generally positive) at regular intervals. 
Usually, an initial value between 0.0 and 1.0 will yield a result. 
An iterative technique is used to compute the IRR. This function 
returns ERROR if convergence to within 0.0000001 does not > 


occur within 20 iterations. In this case, repeating this 
computation with a different value for the guess may produce a 
valid result. 
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Example: 


With an initial investment of $-10,000 and returns of 2000, 
2400, 2800, 3450, and 2800 in cells A1:A6, and an initial 
guess of .01, in cell B1, the IRR is computed as follows: 


IRR(B1,A1:A6) = .1000113 (10.00113%) 


In some cases IRR may have a multiple-valued solution. In 
general, only one interest rate exists for any series of cash flows 
where the zero period cash flow is the only negative payment or 
where the negative cash flows are in sequence beginning with 
period zero. 


Where cash flows have multiple negative payments not in 
sequence, multiple interest rates may exist. In such cases, 
different initial guesses may result in different answers. 


ISBLANK(expression) 


ISB(expression) 


Tests that the cell is blank. The expression must be a cell 
reference since you cannot enter a blank expression. This 
function returns 1 (True) if the cell is a blank cell and 0 (False) if 
the cell contains a formula, text, format text, repeating text, date 
or time value, or entry level format. 


ISDATE(expression) 


ISD(expression) 


Tests the expression for the date value type. This function returns 
1 (True) if the expression is a date value and 0 (False) if the 
expression is not a date value (including a blank cell). 
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ISERROR(expression) 
ISERR(expression) 
ISE(expression) 


Tests the expression for the ERROR value type. This function 

returns 1 (True) if the expression is the ERROR value type and 0 = 
(False) if the expression is not an ERROR value type (including a 

blank cell). 


ISNA(expression) 


Tests the expression for the Not Available value type. This 
function returns 1 (True) if the expression is the N/A value type 
and O (False) if the expression is not the N/A value type 
(including a blank cell). 


ISNUM(expression) 


ISN(expression) 


Tests the expression for a numeric value type. This function 
returns 1 (True) if the expression is a numeric value type and 0 
(False) if the expression is not a numeric value type. Text, 
repeating text, format text, formatted entry level, and string values 
have a numeric value of zero and thus evaluate as true. ISNUM 
also returns true for blank cells. ISNUM returns false for date 
values and time values. 


ISPROT(cell) 


Returns 1 (True) if cell is protected, O (False) if cell is not 
protected. This value is unaffected by the state of the global 
protection flag. 


ISSTR(expression) 


ISS(expression) 


Returns 1 (True) if the expression is text, repeating text, control 
text, string values, and cells formatted at Entry level. Returns O 
(False) for all other data types. 
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ISTIME(expression) 


Tests expression for time value type. This function returns 1 
(True) if the expression is a date/time value less than 1 and 0 
(False) if the expression is not a time value (including a blank 
cell). 


ISVAL(expression) 


ISV(expression) 


Returns 1 (True) if expression results in a numeric value, 
otherwise 0 (False). 


ITER 


Returns the current iteration count. 


m The first iteration returns 1 (not 0 as with some other 
programs). 


E Use ITER to reset values for what-if models. 


Example: 


IFUTER=1,"original","computed") 


JDATE(date value) 


Returns the Julian date number of the date value. This number 


ranges from 1 (March 1, 1900) through 73049 (February 28, 2100). 


Examples of date value entries: 


TODAY 

DATE(9,23,88) 

DVAL(2000) 

Bl where cell B1 contains a date 
entered with a Date Entry function 
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Example: 
Assume cell A3 contains the system date 8/16/88: 
JDATE(A3) or JOATECTODAY) returns 32311. 


JTIME(date value) 


Returns the time value of the non-integral portion of a Julian date 
value, the reciprocal of TVAL. 


KINT(present value,rate,term, period) 


Computes the amount of interest paid in the periodth payment. 
KINT corresponds to the “Solve for I in K’th payment” function of 
a financial calculator. 


The formula is: 


BALANCE(PV,INT,TERM,PERIOD-1)*INT 


KPRIN(present value,rate,term, period) 


Computes the amount of the principal paid in the periodth 
payment. KPRIN corresponds to the “Solve for P in K’th 
payment” function of a financial calculator. 


The formula is: 


PMT(PV,INT,TERM)-KINT(PV,INT,TERM,PERIOD) 


LASTCOL 
LCOL 


Returns the rightmost column number containing data (column A 
is 1). 
Example: 


When the Last Row/Col is Z30, LASTCOL returns 26 
(Z is column 26). 


3-72 SuperCalc Reference Manual 


Functions 


LASTROW 
LROW 


Returns the row number of the last (bottom right-most) cell 
containing data. 


Example: 


When the Last Row/Col is Z30, LASTROW returns 30. 


LCOL 
See LASTCOL. 


LEFT(string,n) 


Returns the first n characters of the string. 


Example: 


LEFTC'This is a string",6) = "This i" 


LENGTH(string) 


Returns the length of the string. 


Example: 


LENGTHC'This is a string") = 16 


LN(value) 


Returns the natural log, log base e, of the value given. LN is the 
inverse Of EXP. (See the EXP function.) 


Value range: Positive numeric value. 


Example: 
LN(S) = 1.60943791243 
LN(EXP(3)) = 3 
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LOG10(value) 
LOG(value) 


Returns the log base 10 (common log) of the value given. 


Example: 


LOG(12) = 1.07918124605 


LOOKUP(value,range) 
LU(value, range) 


Searches for the last value in the range of numbers, date values, 
time values, or strings that is less than or equal to the search 
value given, and returns the adjacent value to the right of the 
search column or below the search row. This function assumes 
that the search range is in ascending order of values. 


A lookup table consists of two adjacent rows or columns 
containing data. A lookup table can be either horizontal or 
vertical. SuperCalc searches the left column of a vertical lookup 
table and returns the adjacent value in the right column. 
SuperCalc searches the top row of a horizontal lookup table and 
returns the adjacent value in the bottom row. 


While LOOKUP is similar to VLOOKUP and HLOOKUP, it differs 
from the other two functions in that: 


1. The layout of the table (horizontal or vertical) is determined 
by the range definition. 


2. The table must consist of either two adjacent rows 
(horizontal) or two adjacent columns (vertical), and you 
cannot specify an offset. 


3. The range is defined as the row or column (singular) that is to 


be searched. The range does not include the adjacent row or 
column that the information is being returned from. 


3-74 SuperCalc Reference Manual 


Functions 


LOWER(string) 


Converts all characters in the string to lower case. This function 
can be used in conjunction with other functions to provide for 
case insensitive searches or comparisons (see FIND or EXACT). 


Example: 


LOWERC"THIS STRING") = this string 


LROW 
See LASTROW. 


LU(value,row/col range) 
See LOOKUP(value, row/col range). 


MAX (list) 

Returns the maximum value of the range. Nonnumeric cells are 
ignored. 

Example: 


MAX(1,500,2) = 500 


MID(string,startnumber,n) 
Returns a substring consisting of length n characters from string, 
starting at the character position startnumber. The position of the 
first character of the string is 0. 
Example: 

MIDC'This is a string",0,4) = This 

MIDC'This is a string",5,4) = is a 

MIDC"This is a string",10,6) = string 
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"This" begins at character position 0, "is a" begins at 
character position 5, and "string" begins at character 
position 10. 


MIN(ist) 

Returns the minimum value in the list. Nonnumeric cells are 
ignored. 

Example: 


MIN(500,300,2,34) = 2 


MINUTE(time value) 
Returns the minute corresponding to the minute portion of time 
value or the fractional portion of a Julian date/time. 
Example: 
MINUTECTIME(14,23,12)) = 23 
MINUTE(32311.045) = 4 
MINUTEC.05) = 12 
MINUTE(13) = 0 (no fractional part) 
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MOD(valuel,value2) 


Returns the remainder that results from the division of value1 by 
value2. 


Example: 
MODQ(10,7) = 3 


The remainder when dividing 10 by 7 is 3. 


MONTH (date value) 
MON(date value) 


Returns the number of the month of the date value or integral 
portion of a Julian date/time (1 for January, 12 for December). 


Example: 


Assume cell A3 contains the system date 8/16/88: 
MONTH(A3) or MONTH(TODAY) returns 8. 
MONTH(32311) returns 8, with DVAL(32311) = 8/16/88. 
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N(cell) 


Returns the numeric value of the cell. Guarantees that a numeric 
result displays. A string or a blank cell has the value 0. 


Example: 


If cell D5 contains 650, and D6 contains the string Hello, 


then: 
N(D5) = 650 
NODO) = 0 


NA 


SuperCalc displays N/A in a cell for which data are not available. 
You can enter the value N/A into a cell using NA. 


If you enter NA without a slash, SuperCalc displays N/A with a 
slash. 


NOT(expression) 

Returns the opposite truth value as the stated expression. 
NOT (true expression) = FALSE 
NOT (false expression) = TRUE 
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Example: 
NOT(B5=5.9) 


Returns the value of 1 (True) if B5 does not contain 5.9. 
Returns the value of 0 (False) if the expression is true. 


NOW 


Generates a value with the integer portion equal to today’s Julian 
date and the fractional portion equal to the current time. The 
value is formatted and displayed as a date. To display the current 
time, use TVAL(NOW). The function TODAY is equivalent to 
INT(NOW). Also see the functions HOUR and MINUTE. 


NPV(rate,range) 


Returns the present value of a group of cash returns at the given 
rate of discount (for example, a discount rate of 10% would be 
entered as .10). The cash amounts are assumed to be projected 
for equal time periods, such as yearly, and the discount rate is for 
that interval. The first cash entry is discounted once, the second 
twice and so forth and added to the total value. Subtracting the 
cost of the investment from the net present value shows whether 
the investment is profitable or not. 


The formula is: 


> (1 -e 


where Vi...Vn = Series of cash flows in range 
int = interest rate 
n = number of cash flows 
i = the current iteration (1 through n) 
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Example: 


is Discount Rate 
68 


The initial investment is $-10,000 (Cell A1). Returns are in 
cells A4 through A8 and a discount rate in cell B2. 


NPV(B2,A4:A8) = 10,573.68. 


When you subtract the original 10,000 investment, the net 
gain is 573.68. 


OR(valuel,value2) 


A logical OR function returns True (1) if either value1 or value2 is 
true. If both values are false, the OR function returns False (0). — 


OR(True,True) = True 
OR(True,False) = True 
OR(False, True) = True 
OR(False,False) = False 


Example: 
OR(B1>500,B1<500) 


Returns the value of 0 only when B1 = 500. 


PAIDINT(present value,rate,term,period) 


Computes the total interest paid after period payments. PAIDINT 
corresponds to the “Solve for interest after K periods” function of 
a financial calculator. 
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The formula is: 


PMT(PV,INT,TERM)*PERIOD- 
PV+BALANCE(PV,INT,TERM,PERIOD) 


PI 


Returns the value of Pi. 


Example: 
PI = 3.14159265359 


PMT(present value,rate,term) 


Computes the equal periodic payment for an ordinary annuity 
with an initial amount of present value at interest rate per period 
and a life of term periods. PMT corresponds to the “Solve for 
PMT” function of a financial calculator. 


The formula used for an ordinary annuity is: 


int 


prin" —— 
1 — (int + 1) 


where prin = principal (present value) 
int = periodic interest rate 
n = term 
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Example: 


The monthly payment on a $50,000 mortgage at 9% annual 
(.0075 monthly) interest for a 30 year (360 months) term is 
calculated in the following screen: 


PMT(50000,.09/12,360) = 402.31 
PMT(B2,B3,B4) = 402.31 


PROPER(string) 


Converts all words in string to proper capitalization. 


Example: 
PROPER("A FINE THING") = A Fine Thing 
PROPER("abraham lincoln") = Abraham Lincoln 


PV(payment,rate, term) 


This function computes the present value of equal payments in a 
simple ordinary annuity, at interest rate per period over term 
periods. PV corresponds to the “Solve for PV” function of a 
financial calculator. 


The formula used is: 


1 -(1+ int)” 
PR a 
int 
where pmt = periodic payment 
int = periodic interest rate 
n = term 
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Example: 


The present value of $100 received at the end of each year 
for 3 years if the payments are discounted at an annual rate 
of 10% is computed as follows: 


PV(100,.10,3) = 248.69 
PV(B2,B3,B4) = 248.69 


RANDOM 
RAND 
RAN 


Returns a random number between 0 and 1. 


Example: 


RANDOM = .69132856972 
To get a whole number, use the INT function with RAN. 


Example: 


INT (RAN*10000) = 6914 


The power of 10 by which you multiply RAN plus one gives you 
the maximum number of digits in your whole number. If the 
value returned by RAN has leading zeros, the INT function will 
return less digits. If RAN returns .0073567, this example formula 
will have the value 73. 
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RATE(future value, present value,term) 


Computes the periodic interest rate for present value to grow to 
future value in term periods. 


The formula for RATE is: 


1/n 
(pe) ~ 
pv 
where fv = future value 
pv = present value 
n = term 
Example: 


A $10,000 bond matures in 4 years to a value of $15,000. 
What is the annual interest rate. 


RATE(15000,10000,4) = .1066819 
(the annual interest rate is 10.66%) 


REPEAT(string,n) 


Repeats the specific string n times. 


Example: 


REPEAT("Go! ",3) = Go! Go! Go! 


REPLACE(originalstring,startnumber,n,newstring) 


Removes n characters from originalstring at position 
startnumber, then inserts newstring at that position. 


Example: 


REPLACE("This one is a string?",0,8,"What") = What is a 
string? 
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RIGHT(string,n) 


Returns the last n characters of the supplied string. 


Example: 
RIGHT("Hear",3) = ear 


ROUND (value, places) 


Rounds value to a specified number of places. First specify the 
value to be rounded, then the placeholder where the rounding is 
to occur. Use - to designate positions to the left of the decimal, 
and + to designate positions to the right of the decimal. The + 
sign is optional; if it is omitted, a positive number is assumed. 
Places is also optional; if it is omitted, 0 is assumed. 


Example: 
ROUND(1234.4321,2) = 1234.43 
Rounded two decimal places right of the decimal 
ROUND(1234.5678,-2) = 1200 
Rounded two decimal places left of the decimal. 


ROUNT(1234.5678) = 1234 


ROUNDUP(value, places) 


Rounds value up to a specified number of decimal places (places 
is optional and will be treated as 0 if not stated). Use - to 
designate positions to the left of the decimal, and + to designate 
positions to the right of the decimal. The + sign is optional; if it is 
omitted, a positive number is assumed. 
Example: 

ROUNDUP(1234.4321,2) = 1234.44 

Rounded up two decimal places right of the decimal 

ROUNDUP(1234.5678,-2) = 1300 


Rounded up two decimal places left of the decimal. 


Formulas and Functions 3-85 


Functions 


ROWS(range) 
Returns the number of rows in the range. ROWS is especially 
useful when used with a named range where the number of rows 
is unknown. 
Example: 
ROWS(C3:F10) = 8 
There are eight rows in the range (3, 4, 5, 6, 7, 8, 9, 10). 
ROWS(QUARTER) = 8 


When the range C3:F10 (same as above) has been named 
QUARTER. 


S(cell) 


Returns the string value of the cell. Guarantees that a string 
displays; numbers display as null strings. 


Example: 
If cell DS = "HERE", then S(D5.J9) = HERE 
If cell D6 = 500, then S(D6) = (nothing displays) 
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SECOND(time value) 


Returns the seconds corresponding to the seconds portion of time 
value or the fractional portion of a Julian date/time. 


Example: 
SECOND(32311.045) = 48 
SECOND(CTIME(14,23,05)) = 5 
SECOND(12) = 0 (no fractional portion) 


SIN(value) 


Returns the sine of the radian angle. 


Return range. -1 to 1 


Example: 
SIN(PI/2) = 1 (sine of PI/2 radians) 
SING@0*PI/180) = 0.5 (sine of 30 degrees) 
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SLN(cost,salvage, life) 


Calculates the straight-line depreciation for one period. With the 
straight-line method, each period’s allowable depreciation is 
identical. 


The formula for SLN is: 


(c—s) 
n 
where c = cost of the asset 
s = salvage value of the asset 
n = useful life of the asset 
Example: 


To depreciate a machine that costs $10,000 with a salvage 
value of $1200 over 8 years: 


SLN(10000,1200,8) = 1100 


The yearly depreciation allowance is $1,100. 


SQRT(value) 


Returns the square root of the value. 
Value Range: Positive numeric value. 


Example: 
SQRTÚ) = 2 
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STD(list) 


Returns the population standard deviation for the values in the 
list. The STD is computed according to the following formula. 


, [XV - AVG} 
n 


where n = number of items in list 
V; = the ith item in list 
AVG = average of values in list 


Standard deviation is a measure of the degree to which individual 
values in the list vary from the mean (average) of all the values in 
the list. A high standard deviation means that the values vary 
greatly, while a low standard deviation means that the values are 
similar. When all values in the list are identical the standard 
deviation is zero. Standard deviation is the square root of the 
variance. (See VAR, the variance function.) 


Example: 


The range A2:A10 has been named SPRINT_TIMES. 


STD(SPRINT_TIMES) = .2970597 
(the population standard deviation of the “sprint times”) 
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The STD function computes the population standard deviation 
and is based upon the n method (biased). You can compute the 
sample standard deviation based upon the n-1 method 
(unbiased) with the following formula: 


SQRT(COUNT(list)/(COUNT(list)-1))*STD(list) 


STRING(x,n) 
Converts the numeric value x to a string with n places to the right 
of the decimal point. Also converts date value x to a string 
representation of the Julian number of the date value. 
Example: 
STRING(1234.4321,2) = 1234.43 
STRINGODATE(DATEG,1,88)),1) = 32143.0 


SUM(list) 


Returns the sum of the values in the /ist Nonnumeric cells are 
ignored. 


Example: 


Cells contain these values: A4=3, B15=5, C15=1, C16=2, 
C17=3, C18=4, C19=5, C20=6. Then, 


SUM(A4,B15,C15:C20) = 29 


SYD(cost,salvage, life, period) 


Calculates the sum-of-the-years digits depreciation for a specified 
period. This is an accelerated depreciation method that allows a 
greater amount of depreciation in earlier periods than in later 
periods. 


~~” 
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a a i SS SEE SSE 


The formula for SYD is: 


(c-— s)*(n-p+1) 
(n*(n + 1)/2) 


where c = cost of the asset 
s = salvage value of the asset 
p = period for which depreciation is computed 
n = useful life of the asset 

Example: 


A machine costs $15,000 with a $1500 salvage value after 8 
years. The following spreadsheet calculates the sum-of- 
the-years depreciation schedule for that machine. 


Nanes for Variables (Colum B) 


Formulas in Colum B 


SYD(COST,SALUVAGE,LIFE,A11) 
SYD (COST, SALVAGE , LIFE, A12) 
SYD (COST, SALVAGE ,LIFE,A13) 
SYD (COST , SALUAGE , LIFE, A14) 
SYD (COST , SALVAGE, LIFE, A15) 
SYD (COST, SALVAGE , LIFE, A16) 
SYD (COST, SALVAGE , LIFE,A1?) 
SYD (COST , SALUAGE , LIFE, A18) 


13586.88 SUN(B11-B18) 


This spreadsheet uses named ranges for the COST, SALVAGE and 
LIFE variables. The names display next to the variables. Likewise, 
the formulas using SYD are displayed as text next to the cells that 
actually contain them. (You do not need either the cell names or 
the displayed formulas for the spreadsheet to work correctly.) 
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TAN(value) 


Returns the tangent of the radian angle. 


Example: 


TANC75*PD = -1 a 
(tangent of .75*PI radians) 


TAN(30*PI/180) = 0.57735026919 
(tangent of 30 degrees) 


TCOL 
See THISCOL. 


TERM(payment,rate,future value) 


Computes the number of periods needed to accumulate future 
value at payment per period, reflecting interest rate. 


TERM uses the formula: 


In(1 + (fv *int/pmt)) 
In(1 + int) 


where pmt = periodic payment 
fv = future value 
int = periodic interest rate 
In = natural logarithm 


Example: 


How long does it take to accumulate $10,000 if one makes 
$100 monthly deposits at 10% annual interest. 


TERM(100,.10/12,10000) = 73.04 (months) 


73.04 / 12 = 6.09 (approximately 6 years) 
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THISCOL 
TCOL 


Returns the column number of the cell where THISCOL is 
entered. 


THISROW 
TROW 


Returns the row number of the cell where THISROW is entered. 


TIME(hh,mm,ss) 


Displays the arguments as a time. 


Example: 


With Time set to 24br, 
TIME(14,23,0) = 14:23:00 


With Time set to 12br, 
TIME(14,23,0) = 2:23:00 PM 


TIMEVALUE(time value or string) 
TVAL(timevalue or string) 


Converts time value, string, or fractional portion of a Julian 
date/time into a time-formatted value. The string must match one 
of the time formats allowed on the User-Define Date Format 
menu; it doesn't need to match the format that is actually selected 
for current display. 


Example: 


With Time set to 24br, 
TIMEVALUE("12:00:00") = 12:00:00 
TIMEVALUE(TIME(12,00,0) = 12:00:00 
TIMEVALUEC5) = 12:00:00 
TIMEVALUE("12:00 PM") = 12:00:00 
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TODAY 


Returns the system date. The desired date must be previously 
entered into your system. If not, the default system date displays 
in the cell (or N/A with some systems). 


A .cal file containing TODAY looks for the current system date 
when the file is loaded. Of course, any other cells that reference 
TODAY will be evaluated based on this current date. 


If you don’t want the date to be dependent on the system date, 
use the DATE function. 


Optionally, on the entry line, type TODAY for the current date, 
but press F9 before pressing Return. This calculates and converts 
the TODAY date into a specific date (today’s DVAL Julian date), 
which does not change when the system date changes. 


TRIM(string) 


Removes all spaces at the beginning and at the end of the string. 
Also replaces multiple consecutive spaces within the string by 
single spaces. 


Example: 
TRIM" This isa string") = This is a string 


TROW 
See THISROW. 


TRUE 


Enters the value 1 (True) directly in a cell. 
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TRUNC(value, places) 


Truncates value to a specified number of decimal places (places is 
optional and will be treated as 0 if not stated). Use - to designate 
positions to the left of the decimal, and + to designate positions to 
the right of the decimal. The + sign is optional; if it is omitted, a 
positive number is assumed. 
Example: 

TRUNC(1234.5678) = 1234 

TRUNC(1234.5678,-2) = 1200 


TRUNC(1234.5678,2) = 1234.56 


TYPE(cell) 

Returns a character which represents cell type. 
B Cell is blank 
E Cell is formatted but empty 
“F? Cell contains a formula 
aa is Cell contains text 
PR” Cell contains repeating text 
dy de Cell contains control text (|) 
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UPPER(string) 


Converts all characters in string to upper case. 


Example: 
UPPER("yeah") = YEAH 


VALUE(string) 


Returns the numeric value of the string. The string should follow 
the number syntax rules. The VALUE function can accept 
fractional input. 


Example: 
VALUE("123") = 123 
VALUE("15/16") = .9375 


VAR(list) 


Returns the population variance of the values in the list. The 
variance is calculated according to the formula: 


E(V, — AVG)? 
n 


where n = number of items in list 
Vi = the ih value in list 
AVG = average of values in list 


Variance is a measure of the degree to which individual values in 
the list vary from the mean (average) of all the values in the list. 
A high variance means that the values vary greatly, while a low 
variance means that the values are similar. When all values in the 
list are identical, the variance is zero. Variance is the square of 
the standard deviation. (See the standard deviation function.) 
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The range A2:A10 has been named SPRINT_TIMES. 


VAR(SPRINT_TIMES) = ..0882444 
(the population variance of the “sprint times”) 


The VAR function computes the population variance and is 
based upon the n method (biased). You can compute the sample 
variance based upon the n-1 method (unbiased) with the 
following formula: 


(COUNT(ist)/(COUNTCist)-1))*VAR(ist) 


VLOOKUP(x,range,column offset) 


VLU(x,range,column offset) 


Returns the lookup value for x of a vertical table specified by 
range on the column defined by column offset. 


The first column of a vertical table defined by range is the index 
column. Values in the index column must be in ascending order 
for VLOOKUP to work properly. VLOOKUP compares the value 
of x with each value in the index column, beginning with the 
upper-left of the range and moving down. First, it locates the row 
that contains the largest numeric, date, time or string value that is 
less than or equal to x. Then, it “looks up” the value in the 
column that is column offset columns away from the index 
column. 
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m When column offset is positive, VLOOKUP looks right. 
m When column offset is negative, VLOOKUP returns ERROR. 


m When column offset is zero, VLOOKUP returns the value in 
the index column. 


Example: 


The same data as the example for HLOOKUP prepared as a 
vertical lookup table are presented below. CENSUS is the 
range A5 to E8. 


U.S. California Los Angeles San Francisco 


192488 18248 922 614 
128888 12888 1152 768 
169898 16898 1448 968 
2488888 28888 1888 1288 


VLOOKUP(1970,CENSUS,2) = 16000 (exact match) 
VLOOKUP(1973,CENSUS,2) = 16000 (rounded match) 
VLOOKUP(1945,CENSUS,2) = 0 (x is too small) 
VLOOKUP(1985,CENSUS,4) = 1200 (largest value for x) 
VLOOKUP(1976,CENSUS,0) = 1970 (rounded by decade) 


WDAY(date value) 


Returns the Julian number of the day of the week of the date 
value (1 for Sunday, 7 for Saturday). 


Example: Assume cell A3 contains the system date 8/13/88: 
WDAY(A3) or WDAY(TODAY) returns 7 (for Saturday). 
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WIDTH(cell or range) 


Returns the width of the column that cell is in or the width of the 
specified range. 


Example: 
If column D is 9 characters wide, then WIDTH(D3) = 9 


YEAR(date value) 


Returns the year corresponding to the year portion of date value 
or integral portion of a Julian date/time. 


Example: 
Assume cell A3 contains the system date 8/16/88: 
YEAR(A3) or YEAR(TODAY) returns 1988. 
YEAR(32311) returns 1988, with DVALG2311) = 8/16/88. 
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Chapter 4 
Macro Commands 


What’s in this Chapter? 


This chapter describes the macro command syntax, lists each 
command by function category, and gives detailed information for 
all macro commands in alphabetical order. See Chapter 2 for 
detailed information on the //Macro commands. 


Macro commands are placed within braces {} such as 
{BRANCH ENTER}. These commands plus keystrokes such as 
/BC1~, comprise the macro statements, which are the actual 
instructions. 


Macro Command Syntax 


Like a programming language, SuperCalc uses a specific syntax 
and specific commands for writing macros. There are two general 
categories of macro commands: Keyboard macros and 
Programming macros. 


When writing macro commands, you'll use the double quote (") 
and braces ({}). All commands can be entered in either uppercase 
or lowercase. 


Using the Double Quote " 


Since macro cells are text cells, you must precede statements 
beginning with any of the following characters and any line that 
could be interpreted as a formula (such as SUM), with a double 
quote ("). Otherwise, SuperCalc tries to execute them as they are 


typed in. 


Macro Commands 
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Macro Command Syntax 


The executable characters, their functions, and equivalent function 
keys (if any) are: 


/ Invoke menu 
s Repeat text 


Switch windows = F6 


& Resume macro execution = F8 
= Goto = F5 

? Help = F1 

! Calculate = F9 

| Format text 


For example, "/gb becomes the macro statement for 
/Global, Border. 


Using Braces { } 


Enclose all macro commands within braces. Most command 
arguments must also be within the braces, except for some 
commands such as {GOTO} location. Arguments can be separated 
by either a space, a comma, or the punctuation mark specified 
with /Global, Optimum, Present, Punctuation, comma is the default. 
Commands and arguments can be uppercase or lowercase. Here 
are some examples: 


{right 2} 
{CALL Sales North,East,Mid, West} 


{GETNUMBER "Enter the total quantity" C24} 
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An argument can be a number, cell reference, named range, or 
formula. For example, you could use any of the following 
methods to move the cursor down four rows: 


m Repeat the command: 
{DOWN} {DOWN} {DOWN} {DOWN} 


m Use a number: 
{DOWN 4} 


m Use a named range: 
{DOWN JUMP} (cell named JUMP contains the value 
4) 


NW Use a cell reference and formula: 
{DOWN D50-6} (cell D50 contains the value 10) 


Some commands allow a string as an argument. When a macro 
command argument allows only a string as a value, you can 
indicate the string with either of these methods: 


m The string itself in double quotes, 
(PROMPT "Income Statement") 


m ‘The address of a cell containing the string, 
{PROMPT C1} 


If you want to enter the characters { and ~ as text, you must 
enclose them in braces, {{} and {~}. See the Macro Commands 
section in this chapter for examples. 


After you are comfortable with the macro commands discussed in 
this chapter, try exploring computed cell references, @ functions, 
and index functions listed below for use within macros (for 
descriptions of computed cell references, index functions, and @ 
functions, see Chapter 3, Functions and Formulas). 
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Macro Command Syntax 


The index functions are: ADDRESS, BEGCOL, BEGROW, CHOOSE, 
COLS, CURADDRESS, CURCOL, CURPAGE, CURROW, CURSHEET, 
ENDCOL, ENDROW, HLOOKUP, INDEX, ITER, LASTCOL, LASTROW, 
LOOKUP, N, ROWS, S, THISCOL, THISROW, VLOOKUP. 


For example, let’s say you have a table of numbers in your 
spreadsheet that you would like to copy to an area below the 


table. 


The cursor is in cell Cl: 


To copy the table in C1:C5 into the next available portion of 
column C, you could create the following macro: 


/C{BTABHDOWN},[CURCOL;LASTROW +1]~ 


Let’s break the statement down into smaller parts and examine 
them: 


ae Copy starting here (C1) 

{BTAB} {DOWN} ending at the bottom of the table 

to 

[CURCOL;LASTROW +1] the cell in the current column, in the 
row after the last row of data in the 
spreadsheet. 

a Return 
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Here is the result of this macro: 


<-—-- The table is duplicated 
starting in cell C8, 


ASAS. ANTAS 


Macro statements can be split across rows as required. That is, if 
a command includes arguments, you can begin the command on 
one row and complete it on the other. For example, you can split 
(GETNUMBER "Enter the total quantity" C24) in several ways. 


Following are two examples of splitting this statement: 


When beginning the second row, you must precede the text with 
an extra quote and space to specify the space between the 
command and the parameter. Ony one quote displays. 
Therefore, in this example, you would enter: 


"space"Enter the total quantity" C24). 


{GETNUMBER 


"Enter the total quantity" C24} 


Macro Commands 4-5 


Macro Command Syntax 


When splitting a command, and no space is expected, place the 
rest of the command directly underneath without using a double 
quote. 


{GET 


NUMBER "Enter the total quantity" C24} 


Using Macros with Multiple Spreadsheets 


When using multiple spreadsheets, you can execute a spreadsheet 
macro from any spreadsheet in memory to act on the current 
spreadsheet when the macro is invoked. The spreadsheet 
containing the macro being executed is called the macro 
spreadsheet. You can also invoke file macros to act on the 
current spreadsheet. 


m Any reference inside the braces {} of a macro command is to 
the macro spreadsheet unless it is qualified by a spreadsheet 
name, page number, or a single exclamation point !, which 
indicates the current spreadsheet. 


Examples: 


{LET SALES!A1,A1} puts the value of cell A1 of the macro 
spreadsheet into cell A1 in the spreadsheet named SALES. 


{LET A1,!A1} puts the value of cell A1 of the current 
spreadsheet into cell A1 in the macro spreadsheet. 


m Any reference outside the braces {}, including slash 
commands, refers to the current spreadsheet unless it is 
qualified by a spreadsheet name, page number, or a single |, 
which indicates the macro spreadsheet. For example, 
/CA1,!A1~ copies cell A1 in the current spreadsheet to cell A1 
in the macro spreadsheet. 
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m Macro commands that transfer control from one location to 
another such as {BRANCH location}, do not look into any 
other spreadsheets in memory unless explicitly requested. 


For example, {BRANCH UPDATE} searches first the macro 
spreadsheet for a named range UPDATE, then searches the 
data directory for a file called UPDATE.xat, then searches the 
paths set with //File,Path for the .xqt file. This command 
does not look into any other spreadsheets in memory for a 
named range UPDATE. 


{BRANCH TEST!UPDATE} searches for the named range 
UPDATE in the spreadsheet named TEST (in memory). 


{BRANCH UPDATE.xqt) does not search in any spreadsheet, 
but searches for a file in the default directory, then searches 
the paths. 


The above rules apply for the following macro commands: 


(BRANCH location) 
(CALL location) 
(DISPATCH location) 
[MENU location) 
{ONBREAK location) 


m To invoke a spreadsheet macro, you press Alt-F5 and enter a 
macro name to execute. When invoking a spreadsheet 
macro, SuperCalc uses the following order to locate the 
macro: 


1. The current spreadsheet 

2. The Macro Name/Range Directory 

You can invoke a macro from any spreadsheet, regardless of 
the current spreadsheet, by using the Macro Name/Range 
Directory. This directory lists all named ranges beginning 


with a backslash A) (generally used for naming macros), in 
alphabetical order for all spreadsheets in memory. 
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To display the Macro Name/Range Directory, you press 
Alt—F3 after pressing Alt-F5. You can use the bar cursor to 
select the macro to execute. Pressing F3 after Alt-F5, 
displays all named ranges with and without the leading 
backslash (\), for the current spreadsheet only. 


If you name a macro with a single letter preceded by a 
backslash (\), you can invoke it by pressing Alt plus that 
letter. 


m To invoke a file macro, you select //Macro, eXecute, and enter 
the filename. When you enter an unqualified filename (a 
filename without the full pathname), SuperCalc looks for the 
file macro in the following order: 


1. Default directory 


2. //File,Spreadsheet datapath 
3. //File,Global datapath 


Keyboard and Programming Macro 
Commands 


SuperCalc uses two kinds of macro commands: Keyboard and 

Programming. Keyboard macro commands automatically perform 
non-alphanumeric keystrokes such as Tab, Arrow keys, function 
keys, etc. Programming macro commands control the SuperCalc 
screen, logic flow of the macro, data input, and file input/output. 


Keyboard Macros Summary 


Following is a table of all SuperCalc’s keyboard macros and their 
corresponding keys. 


Keyboard Macro Corresponding Key 

= Return 

{ABS} F4 (toggle absolute coordinates/graphics 
point to current spreadsheet) 

(ADD1) through {ADD10} Shift-F1 through Shift-F10 (invokes 
attached add-in program) 

(AUDIT) Alt—F1 (invoke AUDIT mode) 

{BACKSPACE} or {BS} Backspace 
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{BTAB} 

{CALC} 

{DELETE} or {DEL} 
{DOWN} or {DN} 
{EDIT} 

{END} 


{ENDSCREEN} or {ENDSCR} 


{ESCAPE} or {ESC} 
{GOTO} location 


{GOTOSHEET} sheetname 


{HELP} 
{HOME} 


{HOMESCREEN} or {HOMESCR} 


(INS) 

{INVOKE} 
{LEARN} 

{LEFT} or {LT} 
{MACRONAME} 


{NAME} 
{NEWSHEET} 
{NEXTSHEET} 


{OSD} 


{PAGEUP} or {PGUP} 
{PAGEDOWN} or {PGDN} 
(PAGELEFT) or (PGLT) 
(PAGERIGHT) or {PGRT} 
{PLOT} 

{PREVSHEET} 


{RIGHT} or {RT} 
{RSD} 


{SHEETWINDOW} 


{STEP} 

{TAB} 

{TABLE} 
(TLABEL) 

(UP) 

(VIEW) 
(WINDOW) 
{ZOOMSHEET} 


Back Tab (Shift—Tab) 

F9 (calculate spreadsheet) 

Del 

Down Arrow 

F2 (toggle EDIT mode) 

End 

CtrEEnd (go to the bottom right cell of 
current window) 

Esc (Escape) 

F5 (Goto location) 

CtrL-F5 (Goto spreadsheet) 

F1 (display context sensitive help) 

Home 


CtrHHome (go to the top left cell of current 


window) 

Ins (Insert) 

Alt—F5 or Alt= (invoke macro) 

Alt—F4 (toggle LEARN mode) 

Left Arrow 

Alt—F3 (display Macro Name/Range 
Directory) 

F3 (display Named Range Directory) 

CtrtReturn (create new spreadsheet) 

Ctr-Plus (+ on the numeric keypad — go 
to next spreadsheet) 

Ctrl-F4 (display Open Spreadsheets 
Directory) 

PgUp 

PgDn 

CtrHLeft Arrow (Page left) 

Ctr-Right Arrow (Page right) 

Alt-F10 (plot chart) 


Ctr-Minus ( on the numeric keypad — go 


to previous spreadsheet) 

Right Arrow 

CtrL-F3 (display Referenced Spreadsheet 
Directory) 

Ctri-F6 or Ctrl-; (switch spreadsheet 
windows) 

Alt—-F2 (toggle Single STEP mode) 

Tab 

Alt-F9 (calculate table) 

F7 (names/ranges toggle) 

Up Arrow 

F10 (view chart) 

F6 or 3 (switch window) 

CtrLF7 (display full spreadsheet from 
multiple spreadsheet display) 
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Programming Macros Summary 


The programming macros fall into four categories: 
= Screen control commands that control the SuperCalc screen. 
= Logic commands that control the flow of the macro. 


m Data input commands that control the keyboard during macro 
execution. 


Mm File control commands that control the file input and output. 


Screen Control Macro Commands Summary 


The screen control commands let you control every part of the 
SuperCalc screen. They control the display window and the 
dialog panel. 


These commands let you precisely control the information that 
displays. You can even develop a macro so that a user would not 
be aware that SuperCalc is the engine behind your macro 
application. 


The following commands control the SuperCalc screen: 


{BEEP nn} Sounds the bell. 

{ENTRYOFF} Clears entry line. 

{ENTRYON} Restores normal operation of the entry line. 

{ERRMSG "string"} Displays a user-defined error message. 

{INDICATOR "string"} Controls the program mode indicator of the 
help line. 

{MACROPROMPT "string") Controls macro prompt area of help line. 

{MESSAGE "string"} Controls help message area of help line. 

(PANELOFF) Freezes dialog panel lines; clears the entry 
line. 

{PANELON} Restores normal dialog panel operation. 

{PROMPT "string"} Controls the prompt line. 

{STATUS "string"} Controls the status line. 

{WINDOWSOFF} Suppresses display window updates. 

{WINDOWSON} Restores window display. 
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Three pairs of toggle commands control the screen display. 
When a macro begins, the default state is ON. When a macro 
terminates, the spreadsheet is in the ON state, even if the 
condition was last toggled OFF within a macro. 


{ENTRYON} {ENTRY OFF} 
{PANELON} {PANELOFF} 
{WINDOWSON} {WINDOWSOFF} 


The area controlled by each pair of toggle commands is illustrated 
as follows: 


E___  [WINDOWSON}  (WINDOWSOFF) 


<— {PANELON PANELOFF 

26 Last Col/Row:A2@ «— [PANELON PANELOFF 
a AO ENTRYOFF} 

Leek Rep abt Crona EIRON PANELOFF} 


You can replace the SuperCalc dialog panel with your own 
messages. The five dialog panel control macros control parts of 
the dialog panel. The following table illustrates the area of 
control for each macro command. 


Macro Command Area of Control 
{STATUS "string"} status line, characters 1 - 80 
{ERRMSG "string"} status line, characters 1 - 80 
{PROMPT "string"} prompt line, characters 1 - 80 
{INDICATOR "string"} help line, characters 1 - 5 
{MACROPROMPT "string") help line, characters 42 - 59 
{MESSAGE "string" } help line, characters 7 - 80 
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For example, the following statements produce the customized 
dialog panel shown below: 


{STATUS "ABC Corporation"} 

{PROMPT "Financial Statement"} 
{INDICATOR "MAY"} 

{MESSAGE "Certified by XYZ Accounting") 
{MACROPROMPT ""} 

{DELAY 10} 


ABC Corporation 


Financial Statenent 
1> 


MAY Certified by XYZ Accounting 


The following rules govern the string argument for the panel 
control macros. 


m The string must be enclosed in double quotes such as 
{STATUS "ABC Corporation"}. A single leading quote here 
does not suffice. 


m An empty string defined with a pair of consecutive double 
quotes ("") suppresses the entire area over which the macro 
command has control. In this example, 

{MACROPROMPT ""} blanks the macro prompt area, which 
displays the macro indicators such as MACRO. 


m The macro command without an argument cancels macro 
control over the appropriate area. The normal SuperCalc 
display returns to that area. Entering {MACROPROMPT} at the 
end of this macro displays the appropriate macro prompt. 
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Logic Macro Summary 


The logic macro commands act together as a group to control the 
flow of the macro program. These macro commands provide a 
powerful tool for creating solutions to a wide variety of problems. 


{BRANCH location} Continues execution at the specified location; 
does not return to command following 
the {BRANCH}. 

{BREAKOFF} Disables the use of CtrHBreak during 
execution. 

{BREAKON} Enables the use of CtrHBreak during 
execution. 

{CALL location exp1,..,exp32} Continues execution at location; returns to 
command following the {CALL}. 

{COMMENT "string"} Describes what the macro statement does. 

{DEFINE cell1,..cell32} Enters {CALL} arguments into specified cells. 

{DELAY nn} Delays macro execution nn seconds. 

{DISPATCH location} Branches to the location stored in specified 
cell. 

{FOR count,start,stop,step, Causes the macro at start-location to be 

start-location} executed a specified number of times. 

{FORBREAK} Terminates a {FOR} loop. 

{GOCURRENT} Returns macro execution to the spreadsheet 
that was current before using 
{GOMACRO}. 

{GOMACRO} Makes the macro spreadsheet the current 
spreadsheet. 

{IF condition} Conditionally executes the succeeding 
command. 

{LABEL label} Names a label in a file macro. 

{LET location,expression} Places value of expression in specified 
location. 

{MACRO} Indicates the beginning of a SuperCalc file 
macro. 

(MENU location) Indicates the beginning of a menu. 

{ONBREAK location} Directs macro execution to location on 
Ctr-Break. 

{ONERROR routine,message, Stores error messages and continues macro 

location} execution. 

{QUIT} Terminates macro execution. 

{RESTART} Voids all pending {RETURN}s implied by 
{CALL}. 

{RETURN} Returns execution to the command 


succeeding {CALL}. 
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Data Input Macro Commands Summary 


The Data Input macro commands let you control the keyboard 


during macro execution. 


(?) 


(0 

{~} 

{BACKUP} 
{BLANK range} 


{BLANKC range} 
{GET location} 
{GETCELLS "prompt" location} 


{GETCOLS "prompt", location} 


{GETKEY "prompt", location} 
{GETNUMBER "prompt", 
location} 

{GETROWS "prompt" location} 


{GETTEXT "prompt", location} 
{INSERTOFF} 

{INSERTON} 

{KEY} 

{LETCONTENTS location, 
"formula") 

(LOOK location) 


{OVERWRITE} 

{READY} 

{RECALC range,condition, 
iterations} 

{RECALCCOL range, 
condition, iterations} 
{REPLACE} 


{SUSPEND} 


Halts execution; allows keyboard entry until 
you press Return. 

Inserts the left-hand brace in text. 

Inserts the tilde character in text. 

Backs up a file if it exists. 

Blanks contents and entry level formats of 
the specified range. 

Blanks only contents of the specified range. 

Waits for entry to store in specified location. 

Waits for cell range to store in specified 
location. 

Waits for column or column range to store in 
specified location. 

Waits for a key to store in specified location. 

Waits for numeric value to store in specified 
location. 

Waits for row or row range to store in 
specified location. 

Waits for text to store in specified location. 

Turns off INSERT mode. 

Turns on INSERT mode. 

Pauses execution for input of a single key. 

Puts formula into location as if entered from 
the entry line. 

Checks to see if the type-ahead buffer is 
holding a character. 

Overwrites a file if it exists. 

Returns you to READY mode. 

Performs a row-wise recalculation of the cells 
in the range. 

Performs a column-wise recalculation of the 
cells in the range. 

Confirms Replace options for Load and 
Import. 

Halts execution until you press F8. 


The GET... macros each contain a prompt argument. When a 
prompt is longer than one word it must be enclosed in a pair of 
double quotation marks. You can also enter a cell address that 
names a cell containing a string value for the prompt. 
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Each of these macros limits the type of data that is acceptable. 
Thus you can use these macros to screen the data entry to ensure 
that it is the proper data type for your application. 


File Control Macro Commands Summary 


The following File Control commands let you control ASCII file 
input and output: 


{CLOSE} Terminates read/write access to opened file. 

{FILESIZE location} Displays total number of bytes of opened 
file. 

{GETPOS location} Displays file pointer position of opened file. 

{OPEN filename,access-mode} Opens an ASCII file for reading and writing. 

{READ character-count, Reads number of characters from open file 

location} and places them in location. 

{READLN location} Reads a line of characters from open file and 
places it in location. 

{SETPOS pointer position} Sets file pointer to specified position. 

(WRITE "string"} Places string into the open file at current 
pointer position. 

{WRITELN "string"} Same as {WRITE} except adds carriage return 


at end of string. 


Macro Commands 


This section describes all the macro commands in alphabetical 
order. For information on all the SuperCalc slash commands, see 
Chapter 2. 


(2) 


Interrupts macro execution and allows keyboard entry until you 
press Return. This command does not restrict input in any way 
— to restrict entry, use (GETNUMBER), {GETTEXT}, {GETCELLS}, 
{GETCOLS}, {GETROWS}, or {GETKEY}. 


You can move around the spreadsheet (using the Arrow keys) 
and/or enter data or commands. Pressing Return resumes macro 
execution. 
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tU 


Inserts the left-hand brace. Use this command to insert the { 
character in text without it being interpreted as a macro 
command. 


There is no need for a corresponding macro statement for the 
closing brace character }. 


Example: 
"This is a sample {{}IF} macro. 
produces the following on the entry line when executed: 


This is a sample {IF} macro. 


Inserts the tilde character. Use this command to insert the ~ 
character in text without it being interpreted as a macro 
command. 
~ is the keyboard macro for Return. == 
Example: 
"Do not press the {~} character. 


produces the following on the entry line: 


Do not press the ~ character. 


{ABS} 


Toggles the absolute values on the entry line or turns on POINT 
mode. In a /Grapbics menu, {ABS} allows pointing into the 
current spreadsheet. 


{ABS} is the keyboard macro for the F4 key. — 
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Example: 


The following macro changes the first cell in a function’s range to 
an absolute coordinate. 


/EC6~ Place contents of C6 (SUM(A8:D8)) in EDIT mode 
{HOME} Move the cursor to cell A1 

{RT 4} Move the cursor over 4 characters to A 

{ABS} Changes the range to SUM($A$8:D8) 


{ADD1} - {ADD10} 


Invokes the add-in program that is attached to the corresponding 
function key. You can attach up to 10 add-in programs. {ADD1} 
through {ADD10} are the keyboard macros for the Shift—F1 
through the Shift-F10 keys. 


{AUDIT} 
Invokes AUDIT mode. 


{AUDIT} is the keyboard macro for the Alt-F1 key. 


(BACKSPACE) or {BS} 
Cancels the last entry in a command path, or backs up and 


deletes one character at a time. 


(BACKSPACE) and (BS) are the keyboard macros for the 
Backspace key. 


(BACKUP) 


Backs up a file if it exists. If the file does not exist, the {BACKUP} 
statement is ignored. Also see (OVERWRITE). 


SuperCalc commands that write files such as //Macro, Write, /Save, 
//Export, and /Output, may prompt you to either Backup, Change, 
or Overwrite existing files. This command is always specified 
immediately after the filename. 
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Example: 


This statement saves the file Quarter2, creating a backup copy of 
the previous version. 


/SQuarter2~{BACKUP}A 


You should not enter a “B” here for Backup. “B” always tries to 
execute. The {BACKUP} command is conditional in that the 
{BACKUP} is ignored when the file does not exist on disk. 


{BEEP nn} 


Makes the computer beep the number of times specified in the 
expression. If you do not indicate a number, the computer beeps 
once. 


Examples: 

{BEEP} Sounds beep once. 

{BEEP 4} Sounds beep 4 times. 

{BEEP C50*3} Sounds beep 3 times the number in cell C50. 

{BEEP CHIMES} Sounds beep the number of times in cell 
named CHIMES. 

{BLANK range} 


Performs the same function as /Blank,,All, blanking contents and 
entry level formats of the specified range. The program doesn’t 
need to be in READY mode for this command to operate. 
Example: 


(BLANK A1:B12} 


blanks cells A1 through B12, including entry level formats. 
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{BLANKC range} 


Performs the same function as /Blank,,Contents, blanking only 
contents of the specified range, not entry level formats. The 
program doesn’t need to be in READY mode for this command to 
operate. 


Example: 
{BLANKC A1:B12} 
blanks cells A1 through B12, but does not blank any entry level 


formats. 


{BRANCH location} 


Continues macro execution at the specified location. 


m Execution does not return to the original branching location 
— use the command {CALL} if you want control to return. 


m There is no limit to the number of branches. 
m You cannot branch from a file macro to a spreadsheet 


subroutine. To branch to a spreadsheet from a file macro, 
see {DISPATCH}. 


m {BRANCH} does not branch into any other spreadsheets in 
memory unless explicitly requested. 


Examples: 


1. The following macro fragment is a switch that branches to 
one of four subroutines named 90DAYS, 60DAYS, 30DAYS, 
and CREDITOK depending on the value of the cell named 
PASTDUE. 


{IF PASTDUE >= 90} {BRANCH 90DAYS} 
{IF PASTDUE >= 60} {BRANCH 60DAYS} 
{IF PASTDUE >= 30} {BRANCH 30DAYS} 
(BRANCH CREDITOK} 
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{BREAKOFF} 
{BREAKON} 


Controls the effect of CtrHBreak during macro execution. These 
commands are like modes. The command stays in effect until 
another one is encountered. 


E With (BREAKON), Ctrk-Break halts macro execution. This is 
the default — all macros begin execution in this state. 


m With (BREAKOFF), you cannot halt a macro using 
CtrEBreak. 


Caution when using {BREAKOFF} 


If the macro goes into an infinite loop with 
{BREAKOFF}, you cannot recover without 
rebooting your computer and possibly losing 
data. 


Example: 


This macro fragment prevents you from exiting the macro with 
Ctrl-Break while entering a number from the keyboard. 


{BREAKOFF} 
{GETNUMBER "Enter Amount of Purchase", PURCHASE} 
{BREAKON} 


{BTAB} 


Moves the cell cursor when used with an Arrow key when in 
READY or POINT mode. In a series of occupied cells, {BTAB} 
followed by a keyboard macro for an Arrow key moves the cell 
cursor to the last occupied cell in the next group of occupied cells 
in the direction indicated. (A cell is not considered occupied if it 
contains a hidden value.) If the cell cursor is already at the last 
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occupied cell, {BTAB} followed by a keyboard macro for an 
Arrow key moves the cell cursor to the edge of the spreadsheet. 


{BTAB} is the keyboard macro for the Shift-Tab key. 


(CALC; 


In a spreadsheet, {CALC} forces spreadsheet recalculation. 


{CALC} is the keyboard macro for the F9 key. 


{CALL location exp1.,...,exp32} 


Temporarily transfers macro control to the spreadsheet location or 
file you specify. Control returns to the position immediately 
following the call. The expression arguments are optional. 


You can omit the word CALL within this command as long as the 
location is not a macro command word, e.g., 
{location expl,...,exp32) 


m You can pass up to 32 arguments. 


m {RETURN} is implied upon encountering the first blank cell in 
the macro. 


m The location must be the location of the subroutine 
containing the {DEFINE} command if the expressions are to 
be used. {DEFINE} will place the expression arguments into 
cells. See {DEFINE} for examples of passing arguments with 
{CALL} commands. 


m {CALL} does not call subroutines in any other spreadsheets in 
memory unless explicitly requested. 


This command is for use in spreadsheet macros only — not for 
use in file macros. Because pending returns cannot be retained 
for file macros, a {CALL} in a file macro is not a valid statement. 


mw A {CALL} cannot be executed from a file macro. 


m You cannot pass arguments with a {CALL} to a file macro. 
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Example: 


The \SETUP routine first calls SCREEN, then returns to the next 
call, PANEL, and returns to the statement directly below the {CALL 
PANEL} statement, where the routine continues. 


\SETUP {CALL SCREEN} 
{CALL PANEL} 


SCREEN {PANELOFF} 
{WINDOWSOFF} 
{BEEP BS) 


PANEL {MESSAGE "Help line message"} 
{MACROPROMPT} 
{STATUS "Status line message"} 
{PROMPT "Prompt line message") 
{DELAY 5} 


{CLOSE} 


Terminates read/write access to the currently opened file opened 
by the {OPEN} command. If no file is open, the macro proceeds 
without interruption. 


Example: 


{OPEN REGION7.prn,M} 


{CLOSE} 


This macro opens the file, REGION7.prn, performs some 
operations, and then closes the file. 
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{COMMENT text} 
{COMMENT} text 


Places comments in a macro. Macro execution continues in the 
next cell of a spreadsheet macro or the next line of the file macro. 


When a file macro is read (/Macro, Read), and you include 
the comment column: 


{COMMENT text} leaves the comment in the macro statement 
column of the spreadsheet macro. 


(COMMENT) text places the text in the comment column of 
the spreadsheet macro for the macro command directly 
preceding it. 


The opposite happens when you write a spreadsheet macro 
to a file macro (//Macro, Write) and you include the comment 
column. 


{DEFINE cell1,...,cell32} 


Enters arguments passed by {CALL} into the cells specified. This 
command is for spreadsheet macros only. 


The first value of a {CALL} is placed into the first cell address 
of its corresponding cell named by {DEFINE}; the second 
value is placed in the second cell; and so on. 


You use {DEFINE} after the call is made. The {DEFINE} must 
reside in the subroutine that is called. 


Named cells may be used provided that the name has been 
previously defined (with /Name) when the {DEFINE} 


command is executed. 


You can use the {DEFINE} statement only once for each 
{CALL}. 


{DEFINE} does not need to be the first statement in the 
subroutine. 
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Example: 


The following example illustrates the flexibility of the {DEFINE} 
command when used with the {CALL} command. 


Let’s say you have named the following cells: 


Cell Name Contents 
D35 JAN 12,000,000 
E47 QUARTER 29,000,000 
F52 RESULT "First Qtr 


Consider these two routines, PROGRAM and STATEMENT. 


PROGRAM en 
{CALL STATEMENT 7, "Computer Associates", 
Jan+3000000,Quarter, Result} 


STATEMENT 
{DEFINE J10J11,J12,J13,J14} 


The contents of J10:J14 become: 


Cell J10 = 7 

Cell J11 = Computer Associates 
Cell J12 = 15,000,000 

Cell J13 = 29,000,000 

Cell J14 = First Qtr 


{DELAY nn} 


Delays the processing of the macro for the number of seconds 
specified. 


æ The default is one second. 
m The number can be expressed as a decimal. 


NH Negative arguments are ignored (no delay). 
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SuperCalc intelligently handles the DOS level keystroke Pause 
(Ctrl-Num), which suspends all computation by the processor 
except for the internal timer. 


For example, if during the execution of {DELAY 60} you press 
Pause, the processor halts — further macro execution cannot 
continue. However, when you press any key to restart the 
processor after the delay period has expired (say 10 minutes), 
SuperCalc realizes that the delay has been fulfilled and resumes 
macro execution immediately. 


Examples: 

{DELAY 3.8} Delays macro execution by 3 and 8/10 seconds 
{DELAY 60} Delays macro execution by one minute 
{DELAY 2*24*60*60} Delays macro execution by 2 days 


{DELETE} or {DEL} 


Deletes the character at the edit cursor. {DELETE} and the 
abbreviated form, {DEL}, are the keyboard macros for the Del key. 


{DISPATCH location} 


Branches to the cell address or subroutine name found in the 
location specified. {DISPATCH location} differs from {BRANCH 
location} in that the cell in the dispatch instruction is not branched 
to; rather the contents of the cell is branched to. 


m As with branch, there is no return to the dispatching routine. 


m The cell address or subroutine name found in the {DISPATCH} 
location must be entered as text. 


m Use {DISPATCH} to return to a spreadsheet macro from a file 
macro. 


m {DISPATCH} does not dispatch into any other spreadsheets in 
memory unless explicitly requested. 
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Examples: 


1. If cell A1=SALES, {DISPATCH A1} would switch macro control 
to the current spreadsheet cell named SALES. 


m This is equivalent to {BRANCH SALES} in a spreadsheet 
macro. 


m You cannot branch from a file macro to a spreadsheet 
macro. You must use {DISPATCH}. 


2. This macro shows how the {DISPATCH} macro command can 
be used. {DISPATCH} reads the cell reference in cell B3 and 
transfers to B6. 


PAT CISCIGLED Louk in ES for the tI 


ELL B6 Must be text. 


{BEEP} Dispatch target. 


{DOWN nn} OR {DN nn} 


Moves the cell cursor down nn rows or deletes nn characters at 
the edit cursor Gin EDIT mode only). {DOWN} and the 
abbreviated form, {DN}, are the keyboard macros for the Down 
Arrow key. 


{EDIT} 


Toggles between ENTRY, POINT, or FILE mode and EDIT mode. 
In READY mode, brings the current cell contents to the entry line. 
{EDIT} is the keyboard macro for the F2 key. 
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{END} 


Moves the edit cursor to the end of the entry line in EDIT and 
ENTRY modes. In MENU mode, moves the menu cursor to the 
last item on the menu. {END} and an Arrow key move the cell to 
the last occupied cell in the direction of the Arrow key. 


{END} is the keyboard macro for the End key. 


{ENDSCREEN} OR {ENDSCR} 


Moves the cell cursor to the bottom right cell of the current 
window. 


{ENDSCREEN} and its abbreviated form, {ENDSCR}, are keyboard 
macros for Ctri-End. 


{ENTRYOFF} 
{ENTRYON} 


Controls the appearance of the entry line Cine 24). 


m {ENTRYOFF) clears the entry line. The entry line remains 
active but does not display. That is, you can still enter data 
and commands as appropriate; they just don’t show on the 
screen. 


m After (ENTRYOFF), other macro statements that use the entry 
line temporarily override the blank entry line. For example, 
the "GET" macro statements override {ENTRYOFF}. 


m {ENTRYON} restores normal display and operation of the 
entry line. 
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Examples: 


1. This macro turns off the display of the entry line but allows 
complete freedom to enter data and commands directly into 
SuperCalc even though they are not displayed. When F8 is 
pressed, the {SUSPEND} terminates and the beep sounds. 


{ENTRYOFF} Blanks the entry line. 


{SUSPEND} Allows keyboard entry until F8. 
{BEEP} Sounds beep. 


2. This macro also turns off the entry line. However, the 
{GETKEY} macro uses the entry line to retrieve the keystroke 
to put into cell B6. After the keystroke, the entry line again 
goes blank and the beep sounds. 


{ENTRY OFF} Blanks the entry line. 


{GETKEY "Press Key",B6} Gets key from entry line and enters it into B6. 
{BEEP} Sounds beep. 


{ERRMSG "string"} 


Related to {STATUS}, {MESSAGE}, and {PROMPT}; displays a user- 
defined error message in white letters, in a red box, at the lower- 
right corner of the screen. 


Use {ERRMSG} with {ONERROR} to display your own error 
messages. 


{ESCAPE} or {ESC} 


Clears data from the entry line when in EDIT or ENTRY mode. If 
you immediately press Esc again (or if you remain in READY 
mode, and then press Esc), the last cleared data is returned to the 
entry line. 
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In a Graphics Entry form, {ESC} returns to the previous menu 
level. 


{ESCAPE} and its abbreviated form, {ESC}, are keyboard macros for 
the Esc key. 


{FILESIZE location} 


Displays a numeric value giving the total size in bytes of the 
currently open file opened by the {OPEN} command. Location 
specifies the spreadsheet cell where the size value is displayed. 
If no file is open, macro execution proceeds without interruption. 
Example: 

{FILESIZE G1} 
puts the current size of the file in cell G1. 


{FOR counter-location, start-number, stop- 
number, step-size, start-location} 


Causes the macro at start-location to be executed a specified 
number of times ((stop-number - start-number)/step-size +1). The 
macro executes one time prior to evaluation of the start-number 
and stop-number. Start-number, stop-number, and step-size can 
be decimal numbers. 


Counter-location is the cell containing the current iteration 
number. 


Start-number is the initial loop iteration value and may be 
positive or negative. 


Stop-number is the ending loop value and may be positive or 
negative. Stop-number must be greater than start-number. 


Step-size is the value to increment the current iteration value. 
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Start-location is the first cell or range name to be executed during 
a loop. 


Example: 
{FOR A1,1,10,1,B1) 


executes a macro starting in cell B1, ten times. The iteration 
number is stored in cell A1. 


{FOR} can only be executed from a spreadsheet macro, not a file 
macro. 


{FORBREAK} 


Causes a {FOR} loop to be terminated. Macro execution continues 
at the macro statement directly following the {FOR} statement. 


Example: 
Within a {FOR} loop, the macro statement 
{IF Al<>2}{FORBREAK} 


terminates the loop if A1 does not equal 2. 


{GET location} 


Interrupts macro execution for you to press a printable key to 
store in the specified location. SuperCalc stores this as text. 


The keyname stored is the abbreviated form as in LEARN mode. 
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Examples: 


1. This example shows two different keystrokes for GET. 


{GET Z1} 


If the user pressed: 


L {GET Z1} stores "L in Z1. 
Fl {GET Z1} stores "{HELP} in Z1. 


2. This macro simplifies inputting a single character as text 
down a column (in this case column C). The cell named 
COUNTER should contain the value one to initialize the input 
at cell C1. Terminate input with CtriHBreak. 


\INPUT {COMMENT Put character in cell column C.) 
{GET [3;¡COUNTER]) 
(COMMENT Increment row counter.) 
{LET COUNTER COUNTER+1} 
{COMMENT Loop back — do it again.) 
{BRANCH \INPUT} 


{GETCELLS "prompt", location} 


Interrupts macro execution for you to enter a cell or a cell range 
to store as text in the specified location. 


m You can type the cell address, point to the cell, or enter the 
cell name. 


WE Using this command while an options menu is on the screen, 


terminates the macro — use only when the spreadsheet 
displays. 
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Example: 


The following macro stops execution for you to enter a cell or a 
cell range and displays Enter the block to update on the prompt 
line and waits for keyboard entry. 


{GETCELLS "Enter the block to update", B15} 
NH If you enter G5, B15 will contain the text G5:G5. 
m If you enter COSTS, where COSTS is the name of the 


range A10:C22, B15 will contain the text A10:C22 rather 
than the word COSTS. 


{GETCOLS "prompt", location} 


Interrupts macro execution for you to specify a column letter or 
column range, and stores it as text in the specified location. 


m You can type the column address, point to the column, or 
enter the column name. 

NW Using this command while full-screen option menus are on 
the screen terminates the macro — use only when the 
spreadsheet displays. 

Example: 


This macro statement interrupts macro execution for you to enter 
or point to the columns, displays Enter the columns to delete on 
the prompt line, and waits for keyboard entry. 


{GETCOLS "Enter the columns to delete", DEL} 


m If you enter AH, the cell named DEL will contain the text 
AH1:AH9999. 


E If you enter C:F, the cell named DEL will contain the text 
CEF9999. 
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{GETKEY "prompt", location} 


Interrupts macro execution for you to press a key, and stores the 
key in the specified location as text. 


This statement is similar to {GET location}, except it includes a 
prompt argument. 


Example: 


This example shows two different keystrokes for GET. 


{GETKEY "Select the next function", Z1} 


If the user presses: 


L {GETKEY} stores "L in Z1. 
F1 {GETKEY} stores "{HELP} in Z1. 


{GETNUMBER "prompt", location} 


Interrupts macro execution for you to enter a numeric value into 
the specified location. 


m If you do not enter a valid number, SuperCalc displays a 
message and waits for you to try again. 


Example: 


The following macro statement displays the prompt, Enter Sales 
Expenses: on the prompt line and waits for a numeric entry. 


{GETNUMBER "Enter Sales Expenses:", C15} 
m Entering 23 puts the value 23 in cell C15. 


m Entering 2*PI enters the numeric value 6.28318530717959 
in cell C15. 
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{GETPOS location} 


Displays the current position of the file pointer in the currently 
open file, opened by the {OPEN} command, in the specified 
location. 


Ææ The first position in a file is always zero. 
mE The pointer moves character by character. 


m If no file is open, macro execution proceeds without 
interruption. 


Example: 


The following macro opens a read-only file and then places the 
pointer location in cell A2 after reading ten characters. 


{OPEN payroll.prn,R} 
{READ 10,A1} 
{GETPOS A2} 


{GETROWS "prompt", location} 


Interrupts macro execution for you to specify a row or a range of 
rows, and stores it as text in the specified location. 


m You can enter the rows, point to the rows, or indicate the 
name of the rows. 


m Using this command while an options menu is on the screen 


terminates the macro — use only when the spreadsheet 
displays. 


4-34 SuperCalc Reference Manual 


Macro Commands 


Example: 


This macro displays the text in cell C5 on the prompt line and 
waits for a row or a row range: 


{GETROWS C5, A11} 
m If you enter 17, cell A11 will contain the text A17:IU17. 


m If you enter 5:10, cell A11 will contain the text A5:IU10. 


{GETTEXT "prompt", location} 


Suspends macro execution for you to enter text and stores the 
text in the specified location. 


m An otherwise numeric entry is converted to text. 


NW An otherwise correct formula is not evaluated — it is entered 
as text. 


m Each text entry is preceded by a double quote (") on the 
status line. 


Example: 


The following statement displays the prompt Enter text:, and puts 
the input as text into cell A10. 


{GETTEXT "Enter text:" A10} 


m Entering COMPUTER ASSOCIATES, places it as text into 
A10. 


NW Entering 23, places it as text into A10. 


m Entering 2*3, places it as the text string 2*3 into A10. The 
multiplication is not performed. 
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{GOCURRENT} 


Returns macro execution to the spreadsheet and page that was 
current before {GOMACRO} was executed. 


{GOMACRO} 


Makes the macro spreadsheet the current spreadsheet, causing the 
macro to execute in the macro spreadsheet. This allows slash 
commands to operate on information in the macro spreadsheet 
instead of the current spreadsheet. Macro execution continues 
from the macro spreadsheet until {GOCURRENT} is executed. 


{GOMACRO} remembers which spreadsheet and page was the 
current spreadsheet before {GOMACRO} was executed. 


{GOTO} location 


Moves the cell cursor to the location specified, or the upper-left 
cell of the named range specified. If no cell is specified before 
Return, SuperCalc puts the current cell in the upper-left corner of 
the current window. 


At the File List, {GOTO} sets the data directory to the current 
directory. 


{GOTO} is the keyboard macro for the F5 key. 


Examples: 
{GOTO} E12~ Moves cursor to cell E12. 
{GOTO} June~ Moves cursor to upper-left cell of range 


June. 


{GOTOSHEET} sheetname 


Makes the specified spreadsheet and/or page the current 
spreadsheet. 


(GOTOSHEET) is the keyboard macro for the CtrHF5 key. 
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Example: 


The following macro loads two spreadsheets, then displays the 
first one. 


/LPROFIT.cal~a Loads the spreadsheet PROFIT.cal. 
//S,N Opens a new spreadsheet window. 
/LSALES.cal~a Loads SALES.cal in the new window. 
{GOTOSHEET} PROFIT~ Displays the PROFIT.cal spreadsheet. 
{HELP} 


Displays the context-sensitive AnswerScreen for commands, 
functions, and error messages. {HELP} is the keyboard macro for 
the F1 key. 


{HOME} 


Moves to cell Al when in READY or POINT mode. In MENU 
mode, moves the menu cursor to the first item on the menu. In 
EDIT or ENTRY mode, moves the edit cursor to the beginning of 
the entry line. 


{HOME} is the keyboard macro for the Home key. 


{HOMESCREEN} or {HOMESCR} 


Moves the cell cursor to the top left cell of the current window. 
(HOMESCREEN) and the abbreviated form, {HOMESCR}, are the 
keyboard macros that position the cell cursor. 


{HOMESCREEN} and {HOMESCR} are the keyboard macros for the 
CtrHHome key. 


{IF condition} 


Conditionally executes the command or commands following the 
{IF} command. 
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When the condition is TRUE, execution continues immediately 
following the {IF} command. When the condition is FALSE, 
execution continues in the next cell (or the next line in a file 
macro). 


Examples: 


The following example tests cell C1. If C1 is 3, control transfers 
to UPDATE. If C1 is not 3, the computer beeps and execution 
continues downward. 


CHECK {IF C1=3} {BRANCH UPDATE} 
{BEEP} 
/BC1~ 
{BRANCH Enter} 


UPDATE {DOWN 2} 
(GETNUMBER COSTS, C1} 


{INDICATOR "string"} 
{INDICATOR} 


Controls the program mode indicator, which normally contains 
one word, such as READY or MENU. This macro controls 
characters 1-5 of line 25. 


m {INDICATOR "string") replaces the current indicator with the 
string (up to five characters). 


m {INDICATOR ""} blanks the indicator area. 
m {INDICATOR} restores the current SuperCalc mode indicator. 
Example: 

{INDICATOR "NEXT"} 


displays the word NEXT in place of the normal indicator. 
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{INS} 


Toggles INSERT mode on and off when in EDIT or ENTRY mode. 
Lets you insert data at the edit cursor. 


Note that {INS} toggles INSERT mode while {INSERTON} and 
{INSERTOFF} assert an INSERT mode state. 


{INS} is the keyboard macro for the Ins key. 


{INSERTOFF} 
{INSERTON} 


Asserts the state of INSERT mode. 
WE {INSERTOFF} turns insert off. 
W {INSERTON} turns insert on. 


These two macro statements assert a given state. You can use the 
keyboard macro statement {INS} to toggle the insert state. 


{INVOKE} 


Executes the current spreadsheet macro specified. {INVOKE} is 
the keyboard macro for the Alt-F5 and Alt= key. 


Example: 
{INVOKE} \SETUP~ 


invokes a macro named \SETUP in the current spreadsheet. 


{KEY} 


Interrupts macro execution for you to press a single key, which 
executes as part of the macro. 


Using Macros 4-39 


Macro Commands 


Example: 


E 


This macro statement shows that you can use {KEY} to store a 
single keystroke in a specified cell. This statements stores the 
key pressed in cell D5 as text. 


{GOTO} D5~ {KEY}~ 


2. This macro statement lets you specify a column from A to Z 
that will be formatted to width 20. 
/FC{KEY},W20~ 

{LABEL label) 


Names a label in a file macro. This label can be referenced by 
{BRANCH}, {MENU}, {CALL}, and so on. 


Since file macros do not contain columns of cells but only rows of 
commands, this statement names locations in the file. 


This command applies only to file macros. If you place this 
statement in a spreadsheet macro, it is ignored. 


When you write a spreadsheet macro to a file macro 
(//Macro, Write,...) and include the labels column, all 
spreadsheet labels are converted to the {LABEL label} format 
in the file macro. 


When you read a file macro into a spreadsheet 

(//Macro, Read,...) and include the labels column, each {LABEL 
label} line is converted into the spreadsheet label format. In 
addition, the name for the labeled cell is defined, i.e., added 
to the named range table. 


This implies that any duplicate named ranges that exist will 
be overwritten with the new named range definition. When 
this happens, the old named range is first substituted with the 
old range addresses, then the new named range is defined. 
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Example: 


The following lines use {LABEL} with {BRANCH} from within a file 
macro: 


(MACRO) Transfers execution to location NET. 
{BRANCH NET} 
Names NET. 
{LABEL NET} 
{LEARN} 


Toggles macro LEARN mode on and off. 


{LEARN} is the keyboard macro for the Alt-F4 key. 


{LEFT nn} or (LT nn} 


In MENU mode, moves the menu cursor to the left. In EDIT 
mode, moves the edit cursor left nn characters. 


{LEFT} and the abbreviated form, {LT}, are the keyboard macros 
for the Left Arrow key. 


{LET location,expression} 


Places the numeric value of the expression in the specified 
location. The expression can also be a string enclosed in double 
quotes. A single leading double quote does not suffice here. 


The value of the expression is put into the cell, not the actual 
expression. 
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Examples: 
1. {LET COST,SUM(B10.B40)} 


places the sum of cells B10 through B40 in the cell named 
COST. ert 


2. {LET Al, "Computer Associates"} 
places the phrase Computer Associates in cell A1. 


{LETCONTENTS location,"formula"} 
{LETC location,"formula"} 


Puts formula into location as if entered from the entry line. All 
formulas must be enclosed in double quotation marks. 


Example: 
{LETCONTENTS B6,"SUM(A1:A6)"} 


puts the formula SUM(A1:A6) into cell BO. — 


{LOOK location} 


Checks to see if the type-ahead buffer is holding a character. If it 
is, the character is placed in the specified location. 


Nothing is placed in the type-ahead buffer when characters are 
typed as responses to commands such as {GETTEXT}, 
(GETNUMBER), etc. 
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Example: 


This macro has a loop that adds 1 to a counter. The user presses 
“S” to stop the macro when the number wanted is displayed. 
{LOOK} checks the buffer, and the loop is terminated when “S” is 
pressed. 


{FOR COUNTER, START STOP STEP , LOOP? 


{LET ANSWER; ANSWER+13 Begin loop. 

{DELAY 5+ Wait 5 seconds between counts. 
{LOOK STORE} Check buffer defined by STORE, 

{IF STORE=S>+*FORBREAK> If STORE is equal to S, then stop. 


Specified cell where increnent count 

is stored, 

Begin count at 2, 

Count up to 12, 

Increment by 2, 

Specified cell where counter is stored. 
Specified cell where contents of butter 
is stored, 


{MACRO} 


This command must be the first statement in a file macro, 
indicating that this is a SuperCalc file macro. 


m The command //Macro, Write automatically inserts this 
command for you — there is no need to add this command 
manually in a spreadsheet macro. SuperCalc ignores 
{MACRO} statements when executing a macro. 


E The command //Macro,Read uses the {MACRO} statement to 
distinguish between SuperCalc file macro format and the 
eXecute file format of prior SuperCalc releases. The {MACRO} 
statement itself is discarded. See Appendix B for more 
information. 


m If you create a macro using a word processor or other 


program that creates files in ASCII format, you must manually 
add the {MACRO} command as the first line in the file. 


Using Macros 4-43 


Macro Commands 


See {MENU location} for an example of a file macro written in 
ASCII format. 


{MACRONAME} 
Displays the Macro Name/Range Directory. 


{MACRONAME} is the keyboard command for Alt-P3. 


{MACROPROMPT "string") 
{MACROPROMPT} 


Controls the macro prompt area of the help line that normally 
displays the macro modes and prompts, such as MACRO, DIRECT, 
LEARN, etc. This macro controls characters 42 - 59 on line 25 (18 
characters). 


m {MACROPROMPT "string") replaces the SuperCalc macro 
prompt with the specified string. 


NE {MACROPROMPT ""} blanks the macro prompt area. mn 


m {MACROPROMPT]} restores the SuperCalc macro prompt. 


Overwriting Characters 42 - 59 


The macroprompt string overwrites the help 
message in characters 42 - 59 when they are in 
conflict. 


{MENU location} 


Indicates the beginning of a menu. If during execution, you press 
Esc instead of making a selection, program control shifts to the anes 
location specified. 
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The escape label location is optional. If no address is specified, 
the program executes a {RETURN}. 


You can use menus in your macros so users can select an item or 
escape to a specified location in the macro. 


Menus appear on the prompt line and act the same as SuperCalc 
menus. 


Menus in a Spreadsheet Macro 


Menus in a spreadsheet macro must be arranged as follows: 


escape location 


¡ES A 


{MENU G1BB> 


Deposits Lookup -menu selections 
Enter deposits Address lookup -help nessages 
{CALL DEP? 44DE?” -macro statements 


{BRANCH UPDATE? 


The first line, {MENU location}, indicates the beginning of the 
menu. Location is the cell address the program jumps to if Esc is 
pressed during menu execution. {MENU} does not look for 
Location in any other spreadsheets in memory unless explicitly 
requested. 


The second line contains the menu selections. These selections 
represent different options of the menu; the user can select one of 
these choices and continue the macro, or press Esc and move to 


the specified location. 


m You can have up to 16 menu selections for each menu. Each 
menu selection is in a separate column. 


m You can have menu selections up to 77 characters long. 


@ Up to 80 characters can be displayed for each menu. 
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The third line contains the help messages you want to appear for 
each selection. These messages replace SuperCalc help messages. 


The fourth line begins the macro commands executed for the 
corresponding selections. Macro execution begins in the column 
where the menu item selected is located. 


Menus in a File Macro 


Menus are formatted a bit differently in a file macro, because a 
file macro is limited to one column. 


//Macro,Read and //Macro, Write automatically convert between a 
file macro and a spreadsheet macro. 


If you are creating a file macro with a word processor, use the 
following format: 


{MACRO} 

{MENU? <——-—- Beginning of the nenu 

Menu selection 1 

Menu selection 2 <——— Menu selections 

Nenu selection 3 

{MENUHELP + <—--- Beginning of help messages 
Help message for first choice 

Help message for second choice <—--- Help messages 

Help message for third choice 

{MENUCHO ICE} <——- Beginning of macro commands 
¿BA1B .A15” for menu selection 1 
{MENUCHO ICE? <——— Beginning of macro commands 
“BAS .A1B™ for menu selection 2 
{BRANCH EDIT} 

{MENUCHO ICE? <—— Beginning of macro commands 
¿CG1"B15” for menu selection 3 
{BRANCH DELETE}? 

{MENUEND? <—--- End of the menu 
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Menu Items 


If a menu item does not have a help message, 
you must insert a blank line where that help 
message would normally appear. Also, if a menu 
item has no commands, the {MENUCHOICE} 
command must still be included. In other words, 
for every menu item there must be a help 
message line and a {MENUCHOICE} command. 


(MESSAGE "string"} 
{MESSAGE} 


Controls the appearance of the help message area of the help 
line. This macro controls characters 7 - 80 on line 25. 


{MESSAGE "string") replaces the current SuperCalc help 
message with string. 


{MESSAGE "") blanks the normal SuperCalc help message. 


{MESSAGE} restores the normal SuperCalc context help 
message. 


When the message is in conflict with other information on line 25, 
the following rules apply: 


The string overwrites the entire help message area (characters 
7 - 80). Thus, a short message will blank out the entire 
normal help message. 


A long message that displays into the area for the special key 
indicators at the right end of the Help line (END, NUM, and 
SCROLL) overwrites those indicators. Thus, you can force 
those indicators to never display by padding the message 
string with sufficient blanks. 
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m@ The {MACROPROMPT "string"} overwrites the message in 
characters 42 - 59. This opens several possibilities. 


- You can design your message for readability around the 
{MACROPROMPT} area using blanks. 


- You can define a null (empty or blank) string for 
{MACROPROMPT ""} to ensure that SuperCalc will not 
display LEARN, MACRO or DIRECT over your message 
and also not interfere with the message string. 


{NAME} 


Displays the Named Range Directory. Displays the File List at a 
filename prompt (FILE mode). Displays the Chart List after 
//Graphics, Name. 


{NAME} is the keyboard macro for the F3 key. 


{NEWSHEET} 


Creates and displays a new spreadsheet in memory. 


(NEWSHEET) is the keyboard macro for CtrlReturn. 


{NEXTSHEET} 


Displays the next spreadsheet in memory. 


{NEXTSHEET} is the keyboard macro for Ctri-Plus (the + on the 
numeric keypad). 


4-48 SuperCalc Reference Manual 


Macro Commands 


{ONBREAK location} 
{ONBREAK} 


Directs macro execution to location upon CtrBreak. 
= {ONBREAK} restores normal CtrHBreak operation. 


m When using {ONBREAK} it is a good idea to place {READY 
location} and {RESTART} at the beginning of the specified 
location. This eliminates potential problems when 
CtriBBreak is issued while deep in a menu path, or from any 
pending {CALL} commands. 


m After (BREAKOFF), if Ctrl-Break is issued from the keyboard 
{ONBREAK location} will not branch to the location specified. 


m {ONBREAK} does not branch to a location in any other 
spreadsheets in memory unless explicitly requested. 


Example: 

{BREAKON} Enable CtrBreak. 

{ONBREAK FIXUP} Branch to FIXUP on CtriEBreak. 
{ONBREAK} Cancel branch to FIXUP on Ctri-Break. 
{BREAKOFF} Disable Ctrt-Break. 


{ONERROR routine, message location} 


Sets up an interrupt handler for errors that would normally abort 
a macro. When an error occurs, macro control transfers to the 
specified routine. 


= Message location is an optional argument. If it is present, the 
SuperCalc error message is stored in that location. If this 


argument is not specified, the message is not saved. 


m If {ONERROR} is present in a macro, error messages are not 
displayed. 
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m If subsequent error messages are trapped, they overwrite the 
current message. 


m You can display the error with the {ERRMSG} command. 

Example: 

If the macro encounters the error Protected entry, 
(ONERROR B25,C1) 


puts the error message into cell C1, and continues macro 
execution at cell B25. 


(OPEN filename,access—mode} 
Opens an ASCII file for reading and writing. 
m The filename is the fully qualified name of the file to be 


opened, including drive, directory, name, and extension, if 
any. 


For existing files, SuperCalc's datapath file search feature 
operates. In this case, the filename need not be fully 
qualified. See the Chapter 5, File Handling, in the User's 
Guide for details on datapath searches. 


m {OPEN} closes any other open files. 


m The access mode is a single character indicating the type of 
file access requested: 
R Read-only access to an existing file. 


W Write access to a new file. 


M Read and write access to an existing file. 
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Examples: 
{OPEN payroll.prn,R} 
opens an ASCII file named PAYROLL.prn with read-only access. 


{OPEN payroll.prn,R}{LBRANCH LOST} 
{READLN B26} 


If the {OPEN} is unsuccessful, this macro executes commands on 
the rest of the line (similar to the {IF} command). In this case, the 
macro would branch to location LOST. 


{OSD} 
Displays the Open Spreadsheet Directory. 


{OSD} is the keyboard macro for the Ctrl-F4 key. 


{OVERWRITE} 


Overwrites a file if it exists. If the file does not exist, the 
{OVERWRITE} command is ignored. Also see {BACKUP}. 


SuperCalc commands that write files, such as //Macro, Write, /Save, 
//Export, /Output, may prompt you to either Backup or Overwrite 
existing files. This command is always specified immediately after 
the filename and answers the prompt. 


Example: 
//MWFORMAT~{OVERWRITE}Z20,A 
overwrites the previous file macro named FORMAT. 
Note that you should not merely enter an “O” here for Overwrite. 
The {OVERWRITE} command is conditional while the letter “O” is 


not. That is, the [OVERWRITE) is ignored when the file does not 
already exist on disk. 
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{PAGEDOWN nn} or {[PGDN nn} 


In READY or POINT mode, moves the cell cursor to the same 
relative position, down nn windows, until it reaches the last row 
in spreadsheet. In a graphics form, pages down within the 
current form. 


(PAGEDOWN) and the abbreviated form, {PGDN}, are the 
keyboard macros for the PgDn key. 


(PAGELEFT nn} or (PGLT nn} 


In READY or POINT mode, moves the cell cursor to the same 
relative position, left nn windows, until it reaches column A of the 
current matrix. A variable column width may change the relative 
position. 


{PAGELEFT} and the abbreviated form, {PGLT}, are the keyboard 
macros for the CtrlLeft Arrow key. 


(PAGERIGHT nn} or (PGRT nn} 


In READY or POINT mode, moves the cell cursor to the same 
relative position, right nn windows, until it reaches the last 
column. A variable column width may change the relative 
position. 


{PAGERIGHT} and the abbreviated form, {PGRT}, are the keyboard 
macros for the Ctrl Right Arrow key. 


(PAGEUP nn} or {PGUP nn} 


In READY or POINT mode, moves the cell cursor to the same 
relative position, up nn windows, until it reaches row 1. 


{PAGEUP} and the abbreviated form, {PGUP}, are the keyboard 
macros for the PgUp key. 
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{PANELOFF} 
{PANELON} 


Controls the display of the dialog panel lines. 
m Macros begin in the {PANELON} state. 


m {PANELOFF} freezes the entire dialog panel. This includes the 
entry line which results in an implied {ENTRYOFF}. If you 
really want the entry line to be ON, you must subsequently 
include the {ENTRYON} macro statement. 


The dialog panel consists of the status line, prompt line, entry 
line, and the help line. 


m After {PANELOFF}, only macro commands (not SuperCalc 
menu commands) alter the panel lines until either a 
{PANELON} is encountered or the macro terminates. 


m The panel does not change, even if the macro passes control 
to the keyboard for data entry by commands such as 
{SUSPEND}. 


For example, you can use {PANELOFF} to design a password 
protection macro to prevent keyboard input from displaying. 


m The panel is automatically turned on when a macro 
terminates — you do not need a {PANELON} statement at the 
end of the macro. 


m Using these commands while an options menu is on the 
screen terminates the macro — use only when the 
spreadsheet displays. 

m  (PANELON) returns the panel to the current SuperCalc 


context. 


{PLOT} 


Plots the current chart on the selected plotter or graphics printer. 


{PLOT} is the keyboard macro for the Alt-F10 key. 
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{PREVSHEET} 


Displays the previous spreadsheet in memory. 


(PREVSHEET) is the keyboard macro for the Ctr+Minus (- on the 
numeric keypad) key. 


{PROMPT "string"} 
{PROMPT} 


Controls the entire prompt line, (characters 1 - 80). 


m {PROMPT "string") replaces the current text on the prompt line 
with the specified string. 


m {PROMPT ""} blanks the prompt line. 

E {PROMPT} reverts back to SuperCalc prompts. 

m After {PROMPT "string"}, other macro commands producing 
prompts, such as {GETNUMBER}, temporarily overwrite the 


string prompt. When these commands are completed, the 
prompt string reappears. 


{QUIT} 


Terminates macro execution and returns control to the 
spreadsheet. 


The following commands are executed automatically with {QUIT}, 
just as they are when a macro terminates normally: {PANELON}, 
{BREAKON}, {WINDOWSON}, and {ENTRYON}. 


Examples: 


1. This macro fragment terminates the macro when the cell 
named PROFIT becomes nonpositive. 


(IF (PROFIT <= 0)} {QUIT 
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2. This macro fragment causes a macro to end that would 
ordinarily execute the next macro command. 


PROGRAM 


= {QUIT} 
SUBROUTINE 


{READ character-count,location} 


Reads the specified number of characters from the currently open 
file opened by {OPEN} and places them in the specified location. 


NW Reading begins at the current pointer position. You can use 
the {GETPOS} command to see where the current pointer is 
located and {SETPOS} to set the pointer where you want it. 


m The file pointer is advanced by the number of characters 
read. 


m If no file is open, macro execution proceeds without 
interruption. 


{READLN location} 


Reads a line of characters from the currently open file opened by 
{OPEN} and places it in the specified location. {READLN} reads 
until it reaches a carriage return/linefeed combination, or until 
end of file. 


m Reading begins in the current line. The entire line is read 
regardless of where the cursor is positioned in that line. 


m The file pointer is advanced to the beginning of the next line. 


m If no file is open, macro execution proceeds without 
interruption. 
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{READY} 


Returns you to READY mode. You can use this macro statement 
to return to READY mode when you are several levels deep in 
SuperCalc’s menus, rather than use repeated {ESC} statements. 
Where {ESC} brings you up to the next highest menu level, 
{READY} brings you all the way back to READY mode. 


{RECALC range,(condition), iteration} 
{RECALCCOL range,(condition), iteration} 


Recalculates cells in a range. 


m {RECALC} performs a row-wise recalculation of the cells in the 
range. Use {RECALC} when the range is located below and to 
the left of the cells it references. 


NW {RECALCCOL} performs a column-wise recalculation of the 
cells in the range. Use {RECALCCOL} when the range is 
above and to the right of the cells it references. 


m If the range is both above and to the left of the cells it 
references, use the {CALC} command. 


E Condition and iteration are optional. When these arguments 
are used, condition is evaluated after the range is calculated 
once. If the condition is false, the range is calculated again. 
Iteration specifies the number of times to calculate the range. 
The range continues to be calculated until the condition is 
met, or the formula has been calculated the number of times 
specified by iteration. 

Example: 


{RECALC A1,(A1>=100),10} 


recalculates A1 until Al equals 100 or until Al has calculated 10 
times. 
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{REPLACE} 


Forces a Zap of the current spreadsheet before loading or 
importing another spreadsheet from disk. 


m When you use the Replace option of /Load,... or //Import.... 
SuperCalc prompts you for confirmation (Yes) when the 
current spreadsheet has been modified. In effect, 

/Load filename, Replace, Yes is the same as /Zap, Yes then 
/Load, filename, All. 


NH The {REPLACE} macro is conditional. That is, it forces 
confirmation of the Replace option when needed, and is 
ignored when not required. 


Example: 


A macro must include both the R for the Replace option and the 
{REPLACE} macro for the conditional confirmation. 


/Lfilename~R{REPLACE} 


{RESTART} 


Voids all implied pending {RETURN} commands. This command 
is for spreadsheet macros only. 


m After every {CALL}, SuperCalc remembers where you called 
from, and returns there when it encounters the corresponding 
{RETURN} command (or implied return). 


m SuperCalc remembers up to 32 calls at one time. If at some 


point in a macro you realize that you do not want to return, 
{RESTART} makes SuperCalc forget all pending call returns. 
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Example: 


The restart in SUB2 cancels the pending returns to SUB1 and 
\MAIN, and continues execution in SUB2. The beep in main 
never executes. 


\MAIN sp 
(CALL SUBI) First pending return. 
{BEEP} 
SUB1 ba 
{CALL SUB2} Second pending return. 
SUB2 was 
{RESTART} Cancel pending returns. 
{RETURN} 


Returns macro execution to the position directly following the 
{CALL} command. 


m A blank cell at the end of a subroutine acts as an implied 
{RETURN} command. 


Æ {RETURN} is most useful in conjunction with {IF}s. 
Examples: 


1. The return at the end of this subroutine is redundant. 


{RETURN} 


2. Statements after the return in this subroutine never get 
executed. 


{RETURN} 
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3. This macro returns to the caller only if C2 is greater than or 
equal to 5. Otherwise, execution continues with the current 
subroutine. 


(IF C2 >= 5} (RETURN) 


{RIGHT nn} or (RT nn} 


Moves the cell cursor right nn cells when in READY mode or 
POINT mode. In MENU mode, moves the menu cursor right as 
needed. In EDIT mode, moves the edit cursor right nn characters. 


(RIGHT) and the abbreviated form, (RT), are the keyboard macros 
for the Right Arrow key. 


{RSD} 
Displays the Referenced Spreadsheet Directory (RSD). 


{RSD} is the keyboard macro for the Ctri-F3 key. 


{SETPOS pointer position} 


Sets the file pointer to the specified position in the file opened by 
{OPEN}. 


m The first position in a file is always zero. 


m The specified position can be a number or an expression 
resulting in a number. 


m The pointer can be set beyond the end of the file. 


m If no file is open, macro execution proceeds without 
interruption. 
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{SHEETWINDOW} 


Switches between spreadsheet windows. 


(SHEETWINDOW) is the keyboard macro for the Ctri-F6 and 
Ctrl; keys. 


Example: 


The following macro displays three spreadsheets and moves the 
cursor to each spreadsheet: 


//8D3 
(SHEETWINDOW) {SHEETWINDOW} (SHEETWINDOW]) 


(STATUS "string"} 
(STATUS) 


Controls the entire status line (characters 1 - 80). 


mM {STATUS "string"} replaces the status line with the specified 
string. > 


E {STATUS "") blanks the entire status line. 


E {STATUS} returns the SuperCalc status line. 


{STEP} 


Toggles STEP mode (single-step operation for macro execution) 
on and off. 


{STEP} is the keyboard macro for the Alt-F2 key. 


{SUSPEND} 


Halts macro execution and allows keyboard entry until you press 
F8. > 


This macro command is similar to {?}, except that you can press 
Return without resuming macro execution. 
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{TAB} 


Moves the edit cursor between the start and the end of the entry 
line when in EDIT or ENTRY mode. In MENU mode, moves the 
menu cursor to the next set of options on window menus. 


{TAB} is the keyboard macro for the Tab key. 


{TABLE} 


Recalculates the current data table set up with //Data, Table. The 
current table is the one whose ranges were last defined. 


{TABLE} is the keyboard macro for the Alt-F9 key. 


{TLABEL} 


Toggles between the name of the range and the range in a 
formula when in ENTRY or EDIT mode. 


{TLABEL} is the keyboard macro for the F7 key. 


Example: 
/EB5~ Put cell BS (SUM(C1:D5)) on entry line. 
{TLABELS} Toggle range to (SUM(SALES)). 


where C1:D5 has been defined as SALES with /Name, Create. 


{UP nn} 


Moves the cell cursor up nn cells when in READY or POINT 
mode. In MENU mode, moves the menu cursor up as needed. In 
EDIT mode, inserts blank spaces at the edit cursor. {UP} is the 
keyboard macro for the Up Arrow key. 
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{VIEW} 


Displays the current chart on the screen. 


{VIEW} is the keyboard macro for the F10 key. 


{WINDOW} 


Switches spreadsheet windows set with the /Window command. 
{WINDOW} is the keyboard macro for the F6 key. 


{WINDOWSOFF} 
(WINDOWSON) 


Controls the display of the display window portion of the screen. 
E {WINDOWSOFF} freezes the screen in its current condition. 
- Subsequent cell cursor movements do not display. 
- You can display a blank spreadsheet by moving to an 
unoccupied area of the spreadsheet before 


{WINDOWSOFF}. 


- Windows are automatically turned on when a macro 
terminates. 


- Using these commands while a fullscreen menu is 
displayed, terminates the macro. Use only when the 


spreadsheet displays. 


E {WINDOWSON} displays the spreadsheet in context. 
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(WRITE "string"} 


Places the string into the currently open file opened with {OPEN} 
at the current pointer position, or copies a cell from the current or 
macro spreadsheet, into the open file. 


m The file must have been opened with “W” (write access to a 
new file) or “M” (read and write access to an existing file), so 
that (WRITE) has write or modify access. 


m After writing, the pointer is moved to the end of the new 
string. 


m If no file is open, macro execution proceeds without 
interruption. 


(WRITELN "string" 


Copies a string into the open file opened with {OPEN} at the 
current pointer position just as (WRITE) does, but adds a carriage 
return line-feed to the end of each string. 


{ZOOMSHEET} 


Enlarges the current display window opened with 

//Spreadsheets, Display, from a multiple spreadsheet display to full 
screen view, and returns the window to its smaller size 
(determined by how many display windows are open). 


(ZOOMSHEET) is a toggle command; the first {ZOOMSHEET} 
enlarges the display window and the second {AOOMSHEET} 
returns the window to the original size. 


{ZOOMSHEET} is the keyboard macro for Ctri-F7. 
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Chapter 5 
Networking SuperCalc 


What's in this Chapter? 


When your system is linked to a network, you will probably want 
to share files on network hard disks (called file servers). Or, you 
might want to use shared devices such as printers and plotters. 
SuperCalc's //Network command, discussed in the first portion of 
this chapter, lets you share those network resources. 


This chapter tells how to link to and unlink from the network file 
directories, lock and unlock data files, and print on network 
output devices. Once you are linked to a directory, SuperCalc’s 
basic file handling commands work as described in the User's 
Guide and Chapter 2 of this Reference Manual. 


Before you can use SuperCalc on your network, the program files 
must be installed by your network administrator. For installation 
instructions, see Network Activation, later in this chapter. 


Guidelines for Using SuperCalc on a 
Network 


1. Use your network software commands to link to the directory 
where the SuperCalc program files are stored. Type SC5 to 
start the program. Then select the SuperCalc option, 
//Network. These options display: Directory, Lock, Unlock, 
Output. 


2. Link to a data directory using //Network, Directory, Link. 


3. Load the file you want, using the standard SuperCalc load 
command, /Load. 
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4. Loaded files are automatically locked. Use //Network, Lock to 
lock any other shared files that are not to be altered by others 
while you are working. 


5. Save any spreadsheet changes you want to retain with /Save. 


6. To print spreadsheets or graphs on a network printer or 
graphics device, use //Network, Output to specify the output 
device. 


7. When you are finished working with a network directory, use 
//Network, Directory, Unlink to unlink it. Be sure to unlink 
from all network directories before quitting SuperCalc. 


Linking to a Directory 


//Network, Directory,Link connects your computer to a directory on 
the network. You can then load files from and save files to that 
network directory. 


1. Select //Network, Directory. A list of linked network directories 
displays. 


2. Select Link, and enter a drive letter (one that’s not already 
assigned). 


3. Enter the path. If the directory is password protected, you 
can type a space after the path and add the password. If you 
don’t include the password with the path, you’ll be prompted 
for it. 


Protecting Files 


On a network, files are in one of two operating modes — locked 
or unlocked. A locked file is protected from anyone else 
changing, adding, or deleting data. All loaded files are 
automatically locked. 
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You can lock files that are not yet loaded to prevent other users 
from changing data during a work session. Use //Network, Lock 
and specify each file you want to lock. The number of files you 
can lock depends on the limits imposed by DOS or your network 
software. To see a list of files you have locked, use 

//Network, Unlock to display the Locked Files Directory. 


If a file is locked by another user, it is in browse mode when you 
load it. You can still read and edit the file, but you must save it 
with a different name. Name changes are inconvenient when 
working with linked spreadsheets. If some of the linked files are 
locked by another user and changes made to your file could 
affect them, it might be best to wait until the files are unlocked 
before proceeding. 


Imported files, because they are translated, are not automatically 
locked. For example, if you import a dBase III file intending to 
return it to dBase III afterwards, someone could modify the 
original file in the interim. To avoid this, use //Network,Lock to 
lock the file while you are working on it. 


SuperCalc file macros are not locked automatically after //Macro, 
Read. To prevent a macro from being modified while you are 
using it, lock it with //Network, Lock. 


Unlocking a file gives other network users write access to that file 
so they can edit it and save the changes under the same name. 
You cannot unlock a file that is locked by another user. Enter 
//Network, Unlock to display the Locked Files Directory. Then, 
enter the filename or point to the file you want to unlock and 
press Return. Quitting SuperCalc unlocks any files you may have 
locked. Zapping a spreadsheet also unlocks the file. 


If you turn off your workstation before quitting SuperCalc, the 
network may consider your workstation to be active. As a result, 
a locked spreadsheet file may remain locked. 
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Sending Files for Output 


Use //Network, Output to select a network device for your output. 
The Network Output Redirection Menu gives you a choice of 
three network ports: LPT1, LPT2, and LPT3. 


Select the port you want. If a password is required, enter it after 
the prompt. Then select: 


m Redirect to send output to the device on a constant basis. 
Output is sent to the specified device as long as new 
directions are not issued. 


Mm  End-redirection to send any subsequent output to your local 
printer or plotting device. Use End-redirection if no 
additional files are to be sent to this location. 


Unlinking 

To detach a directory, select //Network, Directory, Unlink and 
specify the letter of the drive you are detaching. When you quit a 
SuperCalc session, linked directories are not automatically 


unlinked. You must do that explicitly, using either 
//Network, Directory, Unlink or your network software. 


Network Activation 


For Network Administrators Only 


The ACTIVATE program described in this section 
is provided for your network administrator only 
— the person who installs and maintains the 
software on your Local Area Network. Other 
network users should not use the ACTIVATE 
program. 
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You should be using only backup diskettes for installation or 
updates. Keep your original diskettes stored in a safe place. 


This section discusses: 


Initial Network preparation, program file installation, 
Installation and user access to SuperCalc. 

Network Increasing and decreasing the number of 
Maintenance users that can access the program, updating to 


a new version of SuperCalc, moving the 
keyfile, printing a status report, determining 
the current number of SuperCalc network 
users, and changing the source drive. 


The guidelines presented here are written in general terms that 
apply to all supported networks; however, we have given 
network-specific instructions whenever possible. We assume that 
network administrators are familiar with procedures and 
conventions specific to their own networks. 


The ACTIVATE program copies SuperCalc program files onto a 
network server. ACTIVATE also creates a keyfile to maintain the 
user count, which you can change using the Pledge and Release 
options of the ACTIVATE menu. The number of SuperCalc copies 
pledged to the network determines the maximum number of 
concurrent users allowed. 


Maintenance Diskettes 


When new versions of SuperCalc are released, participants in 
Computer Associates’ Support Plus maintenance program should 
check with their dealer or sales representative for the latest 
update information. 
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Multi-User Diskettes 


Rather than using several standard SuperCalc packages, you can 
use a standard package for installation, and a multi-user diskette 
for a more efficient — and cost-saving — way to increase the 
number of users with access to SuperCalc. A three-user diskette 
pack (LanPak) is available from your dealer; contact your dealer 
or Computer Associates for information on larger multiuser site 
licenses. 


Initial Installation 


SuperCalc supports certain networks using IBM DOS Version 3.1 
or higher. For a list of supported networks, see the User's Guide 
Preface. There are four basic steps for installing SuperCalc on 
your network: 


1. Create program and keyfile directories on your network 
server hard disk. 


2. Start the ACTIVATE program included with this version of 
SuperCalc. 


3. Use ACTIVATE to copy the SuperCalc program files to the 
network. 


4. Pledge SuperCalc diskettes to the network, so users can 
access the program. 


The following sections describe each step in detail. 


Create Network Program and Keyfile Directories 


Create two directories on the network server hard disk, one to 
store the SuperCalc program files, the other for the keyfile. The 
keyfile will contain the SuperCalc diskette activate numbers that 
determine how many network users can access SuperCalc. 


For Banyan networks, create one StreetTalk name (containing no 
spaces) for both SuperCalc and the keyfile. 
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Some network software systems, such as 3Com 3+ and IBM PC 
Network, have “access names,” sometimes called Sharenames or 
Shortnames. These access names are designed to control file 
Read, Write, and Create rights. 


Other systems do not use access names, but let you assign access 
rights at the file level (for example, Novell Advanced Netware). 
On these networks, all SuperCalc users need Read, Open, and 
Search access to the program files and the keyfile. The network 
administrator must have all rights to all files. 


For networks with access names, create two access names for 
each directory: one with Read-Only access (for users), the other 
with Read/Write/Create access for the network administrator. 


Access Passwords 


We strongly recommend that passwords, known 
only to the network administrator, be assigned to 
all access names with Read/Write/Create access. 


The following sections give specific examples for preparing the 
program and keyfile directories. Use the one that is appropriate 
for your network. 


3COM 3+ Network Directories 


These instructions create directories in the server’s root directory. 
You can substitute other paths, directory names, and passwords 
(optional) as desired. 


Log in at a workstation as the Server User for the server on which 
you want to install SuperCalc. 
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Enter the following four commands. Note that the drive letter 
represents a server drive. 


3F SHARE CALC=D:\CALC /R 

3F SHARE KEY=D:\KEY /R 

3F SHARE CALCADMN=D:\CALC /PASS=CALCPASS /RWC 
3F SHARE KEYADMN=D: KEY /PASS=KEYPASS /RWC 


Use the following path names when prompted for them in 
ACTIVATE. Substitute your server name for SERVER. 


The SuperCalc path: \\SERVER\CALCADMN 
The Keyfile read path: \\SERVER\KEY 
The Keyfile write path: \\SERVER\KEYADMN 


Network users should link to \\SERVER\CALC. They should not 
link to any of the other directories. 


IBM PC Network Directories 


These instructions create directories in the APPS sub-directory on 
drive C. You can substitute other paths, directory names, and 
passwords (optional) as desired. 

At the server, enter the following commands: 

MD C:\APPS\CALC 

MD C:\APPS\ KEY 

NET SHARE CALC=C:\APPS\CALC /R 

NET SHARE KEY=C:\APPS\KEY /R 


NET SHARE CALCADMN=C:\ APPS\CALC CALCPASS /RWC 


NET SHARE KEYADMN=C:\APPS\ KEY KEYPASS /RWC 
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Use the following path names when prompted for them in 
ACTIVATE. Substitute your server name for SERVER. 


The SuperCalc path: \\SERVER\CALCADMN 
The Keyfile read path: \\SERVER\KEY 
The Keyfile write path: \\SERVER\KEYADMN 


Network users should link to \\SERVER\CALC. They should not 
link to any of the other directories. 


Novell Network Directories 


These instructions create directories in the root of volume SYS:. 
You can substitute other paths, and directory names as desired. 


Log in at a workstation as the administrator. 

Enter the following commands. Note that the drive letter is an 
example only. Use the drive letter you have mapped to 
SYS:PUBLIC. 

MD D:\ CALC 


MD D:\KEY 


Use SYSCON to grant Read/Open/Search rights to users, and all 
rights to the supervisor for both directories. 


Use the following path names when prompted for them in 
ACTIVATE. Substitute your server name for SERVER. 


The SuperCalc path: \\SERVER\SYS:CALC 
The Keyfile read path: \\SERVER\SYS:KEY 
The Keyfile write path: \\SERVER\SYS:KEY 


Network users should map to \\SERVER\SYS:CALC. They 
should not map to the keyfile. 
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STARLAN Network Directories 


These instructions create directories in the server’s root directory. 
You can substitute other paths, directory names, and passwords 
(optional) as desired. 


Log in at a workstation as the administrator for the server on 
which you want to install SuperCalc. 


Enter the following four commands (note that the drive letter 
represents a server drive): 

SRV SHARE CALC=D:\CALC /R 

SRV SHARE KEY=D:\ KEY /R 

SRV SHARE CALCADMN=D:\CALC /RWC /PASS=CALCPASS 
SRV SHARE KEYADMNE=D:\ KEY /RWC /PASS=KEYPASS 
Use the following path names when prompted for them in 
ACTIVATE. Substitute your server name for SERVER. 

The SuperCalc path: \\SERVER\CALCADMN 

The Keyfile path: \\SERVER\ KEY 

The Keyfile write path: \\SERVER\KEYADMN 


Network users should link to \\SERVER\CALC. They should not 
link to any other directories. 


Banyan Networks 


Use MANAGE to create a StreetTalk name for SuperCalc, including 
the Item name, Group name, and Organization name (but no 
spaces). For example: 


CALC@GROUP@ORG 


Grant Control (C) rights to the administrator; grant read-only (R) 
rights to all users. 
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Log in at a workstation as the administrator. 


In Activate, use the following path name when prompted for the 
SuperCalc path, the Keyfile read path, and the Keyfile write path 
(substitute your Item name, Group name and Organization name): 


CALC@GROUP@ORG 


Network users should set a drive to this path. 


Start the ACTIVATE Program 


Place the SuperCalc Utility diskette in drive A of any workstation 
on the network except the network server. 


Type A:ACTIVATE and press Return; the copyright screen 
appears. Press any key to see the ACTIVATE screen. 


Compaq Users 


With a few computers (such as some Compaq 
models with a monochrome monitor), color 
signals sent to the ACTIVATE screen are difficult 
to read. You can replace the colors with shades 
of gray by starting the program with the 
command: A:ACTIVATE/BW. 
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Here is the SuperCalc ACTIVATE screen: 


ACTIVATE Version 1.1 for SuperCalc 


SuperCalc Net Location < Read/Write path to program files Py 
SuperCalc Version < Current SuperCalc version number 

Source Diskette Drive < Source for SuperCalc program files 

Keyf ile Read Path < Read-Only path to keyfile 

Keyf ile Write Path < Read-Write path to keyfile 

Maximum Users < Number of users with network access 


Activate Date Original Date 
Users Number Pledged Version Changed 


Pledge Release Update Move Output Status Drive Quit 


aria Change Drive Quit 


Install SuperCalcS for netuork 


Briefly, here are descriptions of the ACTIVATE menu commands: 

Install Copies the SuperCalc program files to the 
network; then lets you Pledge a SuperCalc 
diskette to the network so users can access 
the program. 


Change Offers another menu, with commands that let 
you adjust the maximum number of network 
users, update your SuperCalc program to a 
new version, check the current number of 
SuperCalc users, print a status report, or 
change to another source drive. 


Drive Changes the Source Diskette Drive (where 
you place the SuperCalc diskette when 
installing, pledging, or updating) to the drive 
you specify (A: or B:) 


Quit Returns you to DOS. 
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Copy SuperCalc Files to the Network 


DOS COPY Won't Work! 


Do not use the DOS Copy command to copy 
program files to the server. The files need to be 
altered to run on the network — ACTIVATE does 
this during the Install and Update procedures. 


ACTIVATE assumes you want to use the A drive to copy the files 
from the diskette — if you would rather use drive B, select Drive 
from the ACTIVATE menu and enter B:. 


Select Install from the ACTIVATE menu; the program prompts 
you for the following information: 


NE Network location for program files. 
E Read Access network directory for keyfile. 
m Write Access network directory for keyfile. 


The following sections explain how to enter the requested 
information. 


Enter Network Location for SC5.COM 


If you set up the directories as described in the example in the 
previous section, use the following: 


For 3COM 3+: \\SERVER\CALCADMN 

For IBM PC Network: \\SERVER\CALCADMN 
For Novell: \\SERVER\SYS:CALC 

For STARLAN: \\SERVER\CALCADMN 


For Banyan: CALC@GROUP@ORG 
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ACTIVATE prompts you for the password if this directory is 
password-protected. 


IBM PC Network with Diskless Workstations 


It is possible to run ACTIVATE on an IBM PC 
Network server. In this case, enter the program 
location as a local disk drive and directory; for 
example: 


For IBM PC Network on the Server: C:\CALC 
ACTIVATE responds with the message: 


Location is on this computer; be sure to Share 
Directory. 


Enter Read Access Network Directory for Keyfile 


If you set up the directories as described in the example in the 
previous section, use the following: 


For 3COM 3+: \\SERVER\KEY 
For IBM PC NET: \\SERVER\KEY 
For Novell: \\SERVER\SYS:KEY 
For STARLAN: \\SERVER\KEY 
For Banyan: CALC@GROUP@ORG 


ACTIVATE prompts you for the password if this directory is 
password-protected. 


A 
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IBM PC Network with Diskless Workstations 


If you are running ACTIVATE on the server itself, 
you must enter the read access network directory 
as above (\\SERVER\KEY) even though it is 
locally accessibly as C:\KEY. Activate will 
respond with the message: 


Because this is the server, ACTIVATE cannot verify 
the name or password. 


ACTIVATE also prompts for a password, if any. 


Enter Write Access Network Directory for Keyfile 


If you set up the directories as described in the example in the 
previous section, use the following: 


For 3COM 3+: \\SERVER\KEYADMN 

For IBM PC Network: \\SERVER\KEYADMN 
For Novell: \\SERVER\SYS:KEY 

For STARLAN: \\SERVER\KEYADMN 

For Banyan: CALC@GROUP@ORG 


ACTIVATE prompts you for the password if this directory is 
password-protected. 


IBM PC Network with Diskless Workstations 


If you are running ACTIVATE on the server 
computer itself, you must enters this as a local 
drive and path. Continuing with the preceding 
example, it would be: C:\ KEY. 
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Insert Product [1] in Drive x: 


m Press Return to copy; messages indicate the file currently 
being copied to the network. 


m You are prompted to repeat the process for the remaining 
diskettes. 


Pledge SuperCalc to the Network 


After all program files are copied, the installation is complete. 
The program immediately starts the Pledge procedure, which lets 
network users access SuperCalc. 


Pledge writes SuperCalc diskette activate numbers to the keyfile, 
and increases the user count accordingly. Any SuperCalc diskette 
used for the Pledge procedure is disabled; however, you can 
reactivate a disabled diskette by performing the Release 
procedure using that same diskette (see Adding SuperCalc 
Network Users later in this chapter). 


When prompted, place the non-write-protected Product 1 diskette 
to pledge into the specified drive and press Return. ACTIVATE 
disables the diskette, adding the appropriate number of users to 
the keyfile. The user count, activate number, date, and version 
number display on your screen in the corresponding fields. 


Copying Utility Diskettes 


ACTIVATE does not copy the SuperCalc Utility 
diskette files — use the DOS Copy command to 
copy these files to the directory of your choice. 


Network Maintenance 


The ACTIVATE Change menu offers commands for various 
network maintenance functions. 
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To reach this menu, select Change from the ACTIVATE menu. 
When prompted, enter the access name with Read/Write/Create 
access to the SuperCalc program files and the keyfile. Type the 
DOS paths to these files if applicable to your network. The Read 
Keyfile directory is automatically entered when you enter the path 
for program file location. 


Here is a brief description of each command on the Change 
menu: 


Pledge Increases the number of users that can access 
SuperCalc, by committing a SuperCalc diskette 
to the network. 


Release Decreases the number of users that can access 
SuperCalc, by releasing a pledged diskette 
from the network; makes the diskette useable 
on a single system again. 


Update Updates your program to a new version or a 
lower revision of SuperCalc. 


Move Moves the keyfile elsewhere on the server. 

Output Prints information you see on your ACTIVATE 
screen. 

Status Shows you how many network users are 


currently using SuperCalc. 


Drive Changes the Source Diskette Drive to a 
different drive (A: or B:). 


Quit Returns you to DOS. 


Adding SuperCalc Network Users 


The Pledge procedure adds SuperCalc users to the network, 
writes SuperCalc diskette activate numbers to the keyfile, and 
increases the user count accordingly. Select Update before Pledge 
if you are updating to a different version or revision of SuperCalc. 
ACTIVATE will alert you if an update is required when a pledge is 
attempted. 
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Pledge Disables Diskettes 


Any SuperCalc diskette used for the Pledge 
procedure is disabled for any other use: it is a 
violation of the SuperCalc license agreement to 
circumvent the disabling by using a copy (a 
backup diskette) for any purpose except backup 
protection of the original diskettes. 


You can reactivate a disabled diskette by 
performing the Release procedure with that same 
diskette. For example, you might want to release 
a copy of SuperCalc to move the program to a 
different server, or to use the program at a non- 
network computer. 


Be sure to save all SuperCalc pledged and 
Maintenance diskettes. 


Pledge Procedures 


Update before Pledge 


Select Update before Pledge if you are updating 
to a different version. ACTIVATE will alert you if 
an Update is required when a Pledge is 
attempted. 


Select Pledge from the ACTIVATE Change menu. When 
prompted, place the Product 1 diskette in the specified drive, and 
press Return. 


ACTIVATE adds one user for standard diskettes, or the designated 


number of users for multiuser diskettes. ACTIVATE also disables 
the diskette. 


5-18 SuperCalc Reference Manual 


Network Activation 


On your screen, the user count, activate number, date, and 
version number display in the corresponding fields. The following 
illustration shows how the screen would look after pledging one 
standard diskette and one three-user diskette (LanPak) to the 
network: 


ACTIVATE Version 1.1 for SuperCalc 


SuperCalc Net Location \NSERVERSSCSADNN 
SuperCalc Version 5 ,BBÁ 

Source Diskette Drive A: 

Keyf ile Read Path MISERVERIMKEY 
Keyf ile Write Path MNSERUVER1MKE YADAN 
Maximum Users 4 


Activate Date Original Date 
Users Number Pledged Version Changed 


1 XXXX-XXX 108 7-21-88 5. BÅ € Standard Diskette 
1 


XXXX-XXX305 7-21-88 5 ,BBA < Three-user Diskette 


Pledge Release Update Move Output Status Drive Quit 


MSF Change Drive Quit 


Install SuperCalc5 for netuork 


Decreasing the Number of SuperCalc Users 


Release unpledges a SuperCalc diskette activate number from the 
network, and decreases the user count accordingly. In addition, 
Release reactivates the diskette for use. 


To release a SuperCalc diskette pledged to the network, choose 
Release from the ACTIVATE Change menu. 


When prompted, place the pledged Product 1 diskette in the 
specified drive and press Return. 


The user count, activate number, dates, and version 


corresponding to this diskette disappear from the screen, and the 
diskette can be used again. 
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Releasing Maintenance Diskettes 


If you pledged a Maintenance diskette (after a 
major Update), ACTIVATE prompts you for the 
original activated diskette, then the latest 
Maintenance diskette, then the original activated 
diskette again. If more than one maintenance 
diskette has been pledged to a activate number 
(subsequent updates), only the latest 
maintenance diskette will be released — the 
earlier maintenance diskette(s) remains disabled. 


Updating to a New SuperCalc Version 


Update copies a different version of SuperCalc to the server. Do 


not use the DOS Copy command for this procedure. 


There are two types of updates: 


Minor The version number (displayed on the 
ACTIVATE menu) doesn’t change but the 
revision letter does. Example: version 3.00A to 
3.00B, or 5.02B to 5.02C. 

Major The version number changes. Example: 
version 5.02 to 5.1. 

Minor Updates 


= Previously pledged activate numbers and user count are not 


changed. 


= You do not need to pledge diskettes after minor updates. 


=» You can update to an earlier revision with the same version 


number. 
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Major Updates 


m With major updates, previously pledged activate numbers and 
user count are temporarily inactivated (user count for all 
activate numbers drops to 0); therefore, you need to pledge 
the maintenance diskette. This reactivates your user count. 


m You must pledge the new diskettes. Afterwards, the 
corresponding activate numbers and user counts are 
reinstated. 


m You cannot update to an earlier version number. Example: 
version 5.00 to 4.00. 


Attention LanPak Users 


You must pledge a Maintenance diskette to all 
previously pledged diskettes. For example, if 
you previously pledged one. single-user diskette 
and one LanPak diskette, you must pledge one 
single-user Maintenance diskette and one LanPak 
Maintenance diskette. 


Update Procedures 


To update to a new version of SuperCalc, choose Update from the 
ACTIVATE Change menu. 


Use a single-user diskette only for this procedure. When 
prompted, place the appropriate diskette in the specified drive 
and press Return. 


Depending on the current SuperCalc version and the version you 


are updating to, ACTIVATE may verify your intentions through 
various prompts; respond accordingly. 
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Moving the Keyfile 


Move moves the keyfile elsewhere on the network server; it does 
not move the SuperCalc program files. 


To move the keyfile, choose Move from the ACTIVATE Change 
menu. At the prompts, enter the new Read-Only access path, 
then the new Read/Write/Create access path for the keyfile (the 
third step of the Initial Installation procedures provides 
instructions for responding to these two prompts). 


ACTIVATE transfers the keyfile to the new network location, 
purging the keyfile from the original location. 


Moving Directories 


To move the SuperCalc program files to another 
network location, use the DOS Copy command 
to copy all program files to the new location, 
then delete the files beneath the original 
directory. You must now specify new paths to 
access SuperCalc. 


Printing a Report 


Output prints a report of all pledged diskette activate numbers, 
with corresponding number of users, version numbers, and dates 
pledged and changed. 


To generate this report, select Output from the ACTIVATE Change 
menu. A report prints, listing all activate numbers pledged to the 
network and their corresponding user access counts. 


Determining Current SuperCalc User Count 


Status displays the current number of concurrent users of ES 
SuperCalc on the network. 
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To check network status, select Status from the ACTIVATE 
Change menu. A message displays in the lower-right portion of 
your monitor, telling you how many users on the network are 
currently using SuperCalc. 


If you forget to Unlink... 


With some network software, if a workstation is 
turned off before exiting SuperCalc, that 
workstation is still counted as an active user — 
and a spreadsheet file may remain locked until it 
is unlocked. To solve this, reboot the offending 
workstation. 


SuperCalc Network Commands 


Within SuperCalc you can perform network functions such as 
linking and unlinking directories, and locking/unlocking files. 
These commands are discussed earlier in this chapter.. 


The number of files a network user can lock with the 

//Network, Lock command depends on the limitations imposed by 
DOS or your network program. You should increase the DOS files 
limit to at least 20 for each workstation, by including the line 
FILES=20 in your workstation CONFIG.sys file (DOS defaults to 
FILES=8). 
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Appendix A 
Messages — Error and 
Advisory 


This is an alphabetical list of messages that might appear on the 
status line, near the bottom right corner of your screen. Some 
messages indicate an error condition; some are merely 
informative. You can also press F1 when you see an error 
message to get on-line help. 


Add-in already attached 


You selected //Add-in,Attach and are trying to attach an add-in 
that is already attached. 


Add-in already attached to that key 


You selected //Add-in, Attach and tried to assign a function key to 
an add-in, but that function key is already assigned to another 
add-in. Use another function key. 


Add-in functions cannot be detached 


You can’t detach an add-in function; you can only detach add-in 
programs. 


Add-in functions cannot be invoked 


Add-in functions are automatically invoked once they’re attached. 


Add-in load error 


The add-in program file that you are attaching or invoking is 
corrupt. Try recopying from the original or obtain replacement 
disks from the manufacturer. 
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Another add-in already set for auto-invoke 


You are using the //Add-in, Attach command and have tried to 
give an add-in the auto-invoke status. You can’t, because another 
add-in already holds this status. Remove the auto-invoke status 
from one program before trying to add it to another. 


Add-in not attached yet 


The add-in program you are trying to invoke is not yet attached. 
Use the //Add-in, Attach command to attach the program before 
invoking it. 


Auditing not enabled 


The file SCA.OVL is either missing or damaged. Recopy from your 
master program disks and retry. 


Bad sector on disk 


SuperCalc has found a bad sector on the specified disk during a 
read or write operation. If you are saving a file, try saving to 
another disk. 


Baud Rate not available 


The baud rate you have selected is not supported by your version 
of DOS. (Versions of DOS less than 3.2 do not support baud rates 
of 19200.) 


Breakpoint occurs while executing macro in 
AutoSTEP mode. 


Your macro execution halted because it encountered a 
breakpoint. 
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Can’t convert file — bad source data or incorrect 
file type 


Either the data file you are trying to import to SuperCalc contains 
bad data or you have specified the incorrect filetype. 


Cannot create file 


SuperCalc5 cannot create the file for one of several reasons. 
Check that your drive door is closed, and that your disk is 
properly formatted, write-enabled and has enough storage space 
to hold the file. 


Cannot create specified directory 


You are at the File List and have tried to create a subdirectory but 
can’t because either the directory already exists, you used 
incorrect pathing syntax, or the disk or drive is write-protected. 


Cannot delete 


You tried to delete a SuperCalc program file. 


Cannot delete file 


The file cannot be deleted because the file was made read-only 
(possibly by using the DOS ATTRIB command) or it has been 
made read-only on the network. 


Cannot invert matrix 


You are attempting to invert a matrix whose determinant is zero. 
Inversion of a matrix with a zero determinant is not possible. 
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Cannot keep new setting. Configuration file is 
read-only. 


You cannot write to the configuration file (for example, to do a 
/Global, Keep, Yes) because someone made it read-only (possibly 
by using the DOS ATTRIB command). You can write a new .CFG 
file under a new name or use /Global, Keep, To to write the file to 
some other drive or directory. 


Cannot lock file - File lock table is full 


SuperCalc keeps a table of all files accessed. To clear, use the 
/Zap command. 


Cannot lock or save file. File was loaded in 
browse mode. 


This message occurs when you load a file in browse mode and 
then try to save it. You cannot save a file loaded in browse 
mode. 


Cannot make directory entry for file 


There is a DOS limitation on the number of files you can have on 
each directory. You’ve received this error message because 
you've entered a command that writes to disk (/Save, 

//Macro, Write, etc.) and your directory has reached its file limit. 
Sub-directories can contain many more files than the root 
directory. Either switch to or create a sub-directory, and try again. 


Cannot open another spreadsheet 


You are attempting to open the 256th spreadsheet. To open 
another spreadsheet, you must clear an existing file out of 
memory. First save a file using /Save, then zap the file using 
/Zap, Yes. Alternately use /Zap,Save to save and remove a file. 
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Cannot start another macro 


You can’t run a new macro; the current macro has executed 
//Restrict, which has activated input mode. The program is 
waiting for input. You can press CtriHBreak to stop the macro, 
or you can press Esc to continue running the macro. 


Cannot unlink program drive 


You've entered //Network, Directory, Unlink but you cannot unlink 
the drive/directory containing the SuperCalc program files. 


Cannot write file; file or disk is read-only 


This applies to DOS 3.0 or higher. Use DOS ATTRIB command to 
change the file to read/write if you need to Save, Output, or 
Export the file to disk. This message also appears when using 
SuperCalc on a network with read-only access. 


Cell(s) out of range 


The SuperCalc data file you are exporting to Lotus 1-2-3 contains 
cells beyond Lotus’ maximum range of 8192 rows (a spreadsheet 
in SuperCalc can have up to 9999 rows). As a result, the cells 
beyond row 8192 are not exported. 


Chart Viewing not supported on monochrome 
displays 


You are trying to view a chart on a monochrome screen without a 
graphics adapter. Install a graphics adapter for your monochrome 
screen or a color monitor. 


Clear current split 


You tried to select a /Window option, but your display is already 
split. Clear the current window before creating another one. 
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Column error 


You have entered a command that requires a column range 
(/Format, Col, /Delete, Col, /Insert, Col, etc.) but you have entered 
something other than a column range. Press Esc and re-enter the 
range. 


Column range error 


The Column range is not specified properly. Correct the error 
and reenter the range. 


Column widths from 0 to 127 only 


You incorrectly specified the column width. Reenter the column 
width, specifying a number from 0 to 127. 


Column/row out of range 


You have entered a column or row located outside the 
boundaries of the current spreadsheet. 


Command aborted due to device error 


This is a non-disk-related error. The program canceled the 
command because of a problem with a peripheral device or 
device driver. Check peripheral devices for hardware problems, 
such as proper cabling. 


Command aborted due to disk error 


The program canceled the command because of a problem with 
the disk or disk drive. You may have put the wrong disk in the 
drive, tried to write to a write-protected disk or drive, or the drive 
may be empty. Also check that the disk is formatted. 
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COMMAND.COM not found 


SuperCalc is unable to locate COMMAND.COM at the location 
stored by DOS. See DOS COMSPEC command to store the correct 
location in DOS. 


Copy won’t fit 


The copy-from range is larger than the copy-to range. Increase 
the size of the copy-to range so that the information fits. 


Creating and changing to specified directory 


This message appears when you are in the File List, creating a 
new directory. 


Criterion range cannot be single row 


The //Data, Criterion range must include field names in the first 
row and at least one other row. The range is usually a block of 
partial rows. 


Criterion range undefined 


Specify //Data, Criterion range before using Find, Extract or Select. 


Define Learn range with //Macro 


You must specify a Learn range to hold macros before you can 
use LEARN mode (ALT-F4). Select //Macro, Learn, then enter a 
range of cells or a single column. 


Device is not redirected 


You have selected //Network, Output, a port, and the option End- 
redirection. The output, however, had not been redirected to 
begin with. 
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Device not ready or out of paper; correct and 
press any key. 


Make sure your printer or graphics device is on and ready. Then 
retry. 


DEVICES.DAT - Version mismatch 


The version of the file DEVICES.DAT is not the same as the other 
SuperCalc program files. Recopy from your master files and retry. 


DEVICES.DAT file format corrupted 


The file DEVICES.DAT is damaged or unusable by SuperCalc. 
Recopy DEVICES.DAT from your master disks and retry. 


Disk error — Press any key to continue 


There is a problem reading or writing to the specified disk — 
press any key, then check for open drive doors and write- 
protection. 


Disk full — command aborted 


You are using the /Save or /Output, File commands and have been 
told your disk is full. Save or output the file to another diskette 
or delete files from your hard disk before continuing. 


Disk full — Press any key to continue 


The disk you are writing to is full. Make room on the disk by 
deleting files or changing to another disk. 


Disk is write-protected 


You are trying to write to either a diskette with a write-protect tab 
attached, or to a disk which is restricted to read-only access by a 
network. 
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Disk read error 


A fatal disk error occurred when you tried to read (/Load, 
//Import) a file. Check the disk and file. Try again. The file, 
however, may be irreparably damaged. 


Disk write error 


A fatal disk error occurred when you tried to write (save, export, 
write) to a disk; try another disk. 


DOS disk or device error 


There is a problem with either your DOS disk or device — try 
another disk. If on a network, see your network administrator. 


Drive not ready 


The door to the drive you are trying to access is open; close it. 


Driver file nnnnnnnn.DRV not on SuperCalc 
directory 


While trying to display, print, or export graphics output, 
SuperCalc cannot find the driver file PRINTERS.drv or 
SCRIBM.drv. The appropriate driver file must be in the SuperCalc 
directory to execute this command. Check your SuperCalc 
directory to see if it’s there. 


Duplicate redirection 


Select another drive — this drive is already linked to another 
network volume. 
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Enhanced output not supported on selected 
device 


SuperCalc does not support enhanced printing features on the 
device you have selected at /Global, Spreadsheet, Device. SuperCalc 
will print in draft mode unless another driver is selected at 
/Global, Spreadsheet, Device. 


Error in macro at (cell/character position) 


You issued an invalid macro specification at the cell and character 
position indicated. The macro has terminated. Correct the error. 
Common errors include forgetting to add a curly brace (()) to a 
macro statement, incorrect spelling, having spaces between words 
in macro statements, forgetting to add RETURN statements (~), 
and having incorrect ranges or cell addresses on {BRANCH} or 
{CALL} statements. When you branch to or call a macro label, 
make sure the label references the named range of the macro 
you're branching to or calling. 


Error in number. Please reenter. 


You can enter numbers only with the macro command 
{getnumber}. Text is not accepted. 


Error in range. Please reenter. 


You did not enter a range with the macro commands {GETCOLS}, 
{GETROWS}, or {GETCELLS}. Enter a range. 


Expanded memory error 


SuperCalc has detected an error in your computer’s expanded 
memory. Consult your EMS manufacturer for diagnostics. 


File already locked 


You have selected //Network,Lock and are trying to lock a file that 
is already locked. 
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File data error 


The disk or file contains an error corrupting one or more 
spreadsheet cells. Try to find cells containing unusual ASCII 
characters that don’t belong. Blank those cells, then Save the 
spreadsheet, Load it again, and reenter the appropriate data. 


File filename must be present on drive d: 


For SuperCalc to run this function, the specified file must be on 
the specified drive. 


File is locked by other sheet or user 


You have selected //Network,Lock but the file you are trying to 
lock has been locked by another user on the network. 


File locked by another sheet or user, file cannot 
be saved 


You have selected /Save but the file you are trying to save has 
been locked by another user on the network and cannot be 
written over. Try saving under another filename. You may also 
encounter this problem if you are loading another copy of a 
locked file. 


File name error 


The filename you have entered contains illegal characters for 
filenames in DOS. See you DOS manual for allowable characters. 


File not found 


The filename you entered is not found anywhere on your search 
paths. Check filename or revise search paths at /Load,F3, 
//File, Path. 
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File not loadable 


You are trying to load a file which contains a format SuperCalc 
can't read. Try using the //Import command to translate the file to 
a format SuperCalc can read. 


File not loadable: enlarge spreadsheet boundary 


Data exists in cells beyond the current spreadsheet boundary. 
Change the spreadsheet boundary setting at the Global, Optimum 
menu to Medium for 2000 rows by 127 columns [DW] or to Large 
(for 9999 rows by 255 columns), then try to load again. 


File not locked 


You have selected //Network, Unlock but you don’t have to unlock 
this file — it’s not locked. 


File not on specified drive or directory 


The file requested is not on the drive or directory specified, or on 
the default drive and directory. Look for the file in other 
directories. Perhaps the file doesn’t exist. 


File not proper add-in 


The file you are trying to attach is not a proper SuperCalc5 add-in 
program. 


First cell must be a format cell 


You are using //Data, Parse, Edit to edit a format line but the cell 
address you’ve specified doesn’t contain a format line. Check that 
the address you’ve specified is correct. 
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First defined variable must be HI, second LO 


For Hi-Lo graphs, the first data variable defines the HI data points, 
and second data variable defines the LO data points. Redefine 
the data variables. 


FONT.DAT must be present to plot extended 
characters 


The FONT.DAT file must be in the SuperCalc directory to plot 
ASCII characters 128-255. SuperCalc cannot find the file. Copy it 
from one of the SuperCalc diskettes to your SuperCalc directory. 


Formula converted to text 


The file you are converting contains a formula of a type that 
SuperCalc does not support, so the program converted instances 
of that formula to a text entry. Determine which formulas are 
involved and edit the file. 


Formula error 


When using /Global," , you see this message if you type anything 
but a valid formula. To enter text, precede text with ” 


Formula unrecognized, converted to text-review 
results 


The file you are converting contains a formula type that SuperCalc 
does not support, so the program converted instances of that 
formula to a text entry. Determine which formulas are involved 
and edit the file. 


Function/cell redefined to be a named range 


In the Lotus 1-2-3 file you were loading, a range name has 
redefined a function or a cell. 
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Graph range error 


You chose a graph range other than a valid graph range (1-9). 
Try again. 


Graphics not enabled 


Because of your environment, //Graphics has been disabled to 
free up memory. Press F1 for instructions on enabling graphics 
features. 


Graphing 
The program is preparing or displaying the specified graph. 


Graphs not present on file 


You tried to Load graphs, but there are no charts currently on 

disk. To see charts in the .CAL files, select /Load, then press F3 

and F6. To see the charts currently in memory, select 

//Graphics, Select, then press F3. — 


Imported named range has redefined a function 
or cell 


The Lotus 1-2-3 file you imported contained a named range that 
redefined a SuperCalc function or a cell. Review the file’s named 
ranges to determine any name conflicts. 


Imported text truncated to 240 characters 


SuperCalc shortened a text entry in the imported file because it 
exceeded SuperCalc’s maximum length of 240 characters. 


Incompatible remote adaptor 


This is a network hardware error — call the site administrator. 
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Incorrect data disk 


The program cannot find the file because the correct data disk is 
not in the data drive. Insert the correct data disk and press any 
key. 


Incorrect driver file: nnnnnnnn.DRV 


Each SuperCalc program has a version — for example, a 
SuperCalc3 program file has a different version number than a 
SuperCalc version 5.0 file. You cannot output if the driver file 
does not match the program files. To check, use the DOS DIR 
command to list the SuperCalc program files; they should all show 
the same date. If you find an incompatible file, copy the current 
driver file from your master disk. 


Input range cannot be single row 


With //Data,Input, the range must include field names in the first 
row and at least one other row. The range is usually a block of 
partial rows. 


Input range undefined 


Specify the //Data, Input range before using Find, Extract, Delete, 
or Select. 


Insert color » in stall n and press any key 


While plotting you requested a pen color that is not currently in 
its plotter stall. Insert the desired pen color in the specified stall 
(slot) and press any key to continue plotting. (On a two-pen 
plotter, stall 2 is on the right side.) 


Insert other Work Disk in drive A and press any 
key 


The desired activity requires files on the other SuperCalc program 
diskette. Remove the current Work Disk from the drive and 
replace it with the other Work Disk. 
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Insert paper and press any key 


Insert paper in your printer and press any key. This message 
appears when you output to printer if the Paper Wait setting on 
the Output Options menu is Yes (the initial program default). 


Insert pens 0-n and press any key 


Install the desired pen colors and strike any key to start plotting. 
(Place pen 0 in slot 1, pen 1 in slot 2, etc.) 


Insufficient memory 


The function you are trying to accomplish requires more memory 
than is currently available. 


Insufficient memory for alternate font 


Not enough space available for program to load graph Fonts 2 
through 8. At least 9K of contiguous memory space needed. 
Redefine all fonts to Font 1. Or make more space available in 
memory at the Global, Optimum menu or by deleting unneeded 
data in the spreadsheet. If the message persists, the reclaimed 
memory is not contiguous, so Save the file, Zap the spreadsheet, 
Load the file again, and try again. 


Insufficient memory for enhanced output, 
changing to draft mode 


There are two types of output: final and draft. Final includes a 
choice of fonts, lines, grids, boxes and shade — and uses more 
memory for these options. Draft doesn't use any of these options. 
You don't have enough memory to use final output, so SuperCalc 
switched you to draft. To gain more memory to use final output, 
you can temporarily turn off graphics — see the error message 
Insufficient memory for macro analyzer for instructions. 
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Insufficient memory for macro analyzer 


SuperCalc does not have enough memory to perform the analysis. 
To gain more memory, you can temporarily turn off graphics. If 
you do, first save your file. Then turn off graphics by typing 
/Global, Optimum, Next,Graphics,No. Keep this setting by typing 
/Global, Keep, Yes. Then re-start SuperCalc by typing /Quit, To,SC5. 
When you reload your file, you should be able to analyze it. 


Insufficient memory to arrange 


There was not enough memory available for the arrange 
operation. 


Insufficient memory to display all files 


You pressed the F key to display the list of SuperCalc (CAL) 
data files, but there is not enough memory to list all the files. 
Blank data to free up memory, or Save the file and then look at 
the File List. 


Insufficient memory to enable Undo 


When you use the Undo option, SuperCalc saves two copies of 
your spreadsheet: one with the Undo option used and one 
without. SuperCalc doesn’t have enough memory to save two 
copies of your spreadsheet. To create more memory, Save and 
Zap some open spreadsheets. 


Insufficient memory to list all files 


You pressed the F3 key to display the list of SuperCalc (.CAL) 
data files, but there is not enough memory to list all the files. 
Blank data to free up memory, or Save the file then look at the 
File List. 


Insufficient memory to operate SuperCalc 


SuperCalc requires a minimum computer memory (RAM) size of 
512K. 
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Insufficient memory to plot extended characters 


See “Insufficient memory for alternate font.” 


Invalid column width 


Using the /Format command, you have specified a column width 
greater than 127. Specify a column width less than or equal to 
127. 


Invalid drive specified 


You specified a drive that does not exist on your computer 
system. Correct your drive designation entry. For example, B: 
means drive B. 


Invalid filename; must follow DOS or OS/2 
filename conventions 


The filename is not in the proper format. See the DOS manual 
for instructions on valid filename and file specification entries for 
your version of DOS. 


Invalid format in file — modify before importing 
(//Import) 


SuperCalc does not accept a format in the file you are converting. 
Go into the original file and change the format to one that 
SuperCalc accepts. For more information, see the section on 
//Import in the Reference Manual. 


Invalid format type 


SuperCalc does not accept a format contained in the file you are 
converting. Go into the original file and change the format to one 
that SuperCalc accepts. For more information, see the section on 
//Import in the manual. 
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Invalid help file 


The file SC5.HLP is either damaged or an incompatible version. 
Recopy SC5.HLP from your master disks. 


Invalid input 


Your input is incorrect. You may have entered a nonexistent 
named range or an invalid range. Determine the proper input and 
reenter. 


Invalid number 


The number you entered is outside the acceptable range, or you 
entered the number incorrectly. 


Invalid password 


You have entered the wrong password, try again. 


Invalid range name 


In naming a range you used an unacceptable format or character. 


Invalid scale limits for log axis (negative or zero) 


At the (/Grapbics, Axis) Axis Scaling Options menu, you have 
specified a nonpositive number for the log axis. Only a positive 
number is acceptable for this setting. 


Invalid sheet or page 


You have entered a page number greater than 255 or a sheet 
name with illegal DOS characters. 


Invalid Y-range 


The Y-range entered at //Data Analysis, Regression, Yrange must 
contain the same number of rows as the X-range. 
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Keys must be within sort range 


With /Arrange, your primary or secondary sorting key (row or 
column) lies outside the sorting range. 


Label too large to graph — shorten 


The label length exceeds space available. Shorten the label. 


Last column contains data 


You cannot insert a column because the last column of the 
current spreadsheet boundary contains data. Delete or move the 
data in the last column to another location, then try again. 


Last row contains data 


You cannot insert a row because the last row of the current 
spreadsheet boundary contains data. Delete or move the data in 
the last row to another location, then try again. Or enlarge the 
spreadsheet boundary at the Global, Optimum menu after saving 
the current spreadsheet. 


Learn range full 


Macro entries are about to exceed the size of the Learn range. 
Add more rows to the Learn range with the //Macro, Learn, Range 
entry. 


Macro cells deleted 


The current portion of the macro has deleted cells within the 
macro. The macro cannot be executed. To prevent this problem 
in the future, use /Protect to protect all cells in the macro so they 
can’t be erased or overwritten. 
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Macro won't fit 


With //Macro, Read or //Macro, Write, there isn’t enough space 
either to the left of the macro for labels or to the right of the 
macro for comments. Redefine the macro range. 


Manual scaling: Max must be greater than Min; 
redefine scaling 


Maximum must be greater than Minimum. 


Matrices incompatible for multiplication 


To multipy matrices, the number of columns in the first matrix 
must be equal to the number of rows in the second. Check your 
matrices and reenter the command. 


Matrix too large 


The maximum matrix size that SuperCalc will multiply, solve or 
invert is 90 by 90. The matrices you have specified are larger than 
90 by 90. 


Memory full 


The computer memory is full. If your spreadsheet is in memory, 
you cannot add anything to it until you free up memory. Before 
doing so, you may want to Save your spreadsheet. To free up 
memory, you can delete unneeded data from the spreadsheet. Or 
open up memory for data at the Global,Optimum menu: either 
change the Memory setting from Fast to Data-space, or change 
the maximum Spreadsheet Boundary to Small if your current 
spreadsheet fits in 254 rows by 63 columns (column.BK). Note 
that your Optimum menu setting may already be Data-space and 
Small if your computer memory is less than 384K. 
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Memory full; minimal calculation mode disabled 


Minimal calculation mode takes up memory. As you use memory 
to open more spreadsheets or make spreadsheets larger, 
SuperCalc eventually takes memory away from minimal 
recalculation mode. This shuts it off. 


Memory full; not all names shown 


You've pressed F3 to display the names of all named ranges 
outside the range you loaded with the Load, filename, Part 
command, but there is not enough memory to do so. 


Memory too full to graph; adjust density, 
Global,Optimum,Memory, or Boundary 


Graphs are written to memory before they’re sent to the printer. 
The graph you specified requires more memory than currently 
available. You can simplify the graph (for example, if Resolution 
at the Global,Graphics, Options menu is set to Triple or Quad 
density, change it to Double or Single density — Single is the 
default). Or try one of the solutions under the Memory Full 
message. 


Must be a text cell 


You are using the //Data, Parse, Create command. The cell you 
have specified must contain text. It doesnt. To change a 
numeric cell to a text cell, precede the entry with a quote. 


Must be in LEARN 


You pressed ALT—F6 to enter DIRECT mode, but you cannot 
enter this mode unless you are in LEARN. (To start LEARN mode, 
press ALT—F4.) 
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Name already defined 


At the Reference Spreadsheet Directory, you are trying to use a 
name for a file that you have already used on another file. Use a 
different name. 


Name does not exist 


You are using /Name, Delete to delete a name, but the name 
you've entered does not exist. Check to see that you've entered 
the correct name. 


Name redefines a cell 


The range name you specified is a cell address and will redefine 
that cell. If, for example, you name a range C3, the program will 
substitute the range whenever the cell coordinate is entered or 
referenced. 


Name redefines a column 


The range name you specified designates a column and will 
redefine that column (even if the named range and the column do 
not coincide). If, for example, you name a range CA, the 
program will substitute the named range whenever the column is 
entered or referred to. 


Name redefines a function 


The range name you specified is the name of a formula function 
and will redefine that function. If, for example, you name a range 
SUM, the program will substitute this range when you try to use 
the SUM function. 


Name redefines a range 


The command //Name, Create, All redefines the SuperCalc 
Range, All, (the entire spreadsheet) as whatever range you specify 
here. 
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Name will replace references to that cell 


The range name you specified is a cell address and will redefine 
that cell. If, for example, you name a range C3, the program will 
substitute the range whenever cell C3 is referenced. 


Name will replace references to that column 


The range name you specified designates a column and will 
redefine that column (even if the named range and the column do 
not coincide). If, for example, you name a range CA, the 
program will substitute the named range whenever column CA is 
referenced. 


Name will replace references to that function 


The range name you specified is the name of a formula function, 
and will redefine that function. If, for example, you name a range 
SUM, the program will substitute this range when you try to use 
the SUM function. 


Names cannot be numbers 


In naming a range (/Name, Create), you used an unacceptable 
format or character. See the /Name discussion in Chapter 2. 


Need FONT.DAT in SuperCalc directory to plot 
extended characters 


The FONT.DAT file must be in the SuperCalc directory to plot 
ASCII characters 128-255 — SuperCalc cannot find the file. Copy 
the FONT.DAT file from your master disk to the SuperCalc 
directory. 


Negative numbers ignored in Pie Graphs 


In Pie graphs, negative numbers are not plotted. 


A-24 SuperCalc User's Guide 


Negative numbers treated as zero 


Negative numbers are plotted as though their value were zero in 
Stacked-Bar or Area graphs. Negative numbers are ignored in Pie 
graphs. 


Network adaptor hardware error 


DOS error — see your DOS manual. 


Network busy 


DOS error — see your DOS manual. 


Network command limit exceeded 


DOS error — see your DOS manual (PC-Net only). We 
recommend you change your start-up parameters. 


Network device fault 


DOS error — see your DOS manual. 


Network device no longer exists 


That network device is no longer “shared.” 


Network error 


DOS error — see your DOS manual. 


Network not installed 


You are giving //Network commands on a computer that has not 
been installed on the network. 
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Network session limit exceeded 


DOS error — see your DOS manual (PC-Net only). We 
recommend you change your start-up parameters. 


Network temporarily paused 


You have paused device redirection (PC Net only). 


No Add-in attached to this key 


You have pressed a Shift-Function key to invoke an add-in, but 
no add-in has been attached to that key. Check which key 
combinations you have attached to add-ins by typing //Add-in. 


No Add-ins attached 


You are using the //Add-in command to detach or invoke an add- 
in but no add-in is attached. 


No files locked 


You have chosen the //Network, Unlock command, but none of the 
files are locked. 


No graph size; redefine plotter layout settings 


Redefine plotter layout selections at the Global, Graphics, Layout 
menu. The graph size or offset you entered in Manual mode 
does not fit page size, or cannot be plotted. 


No linked directories 


There are no linked network directories to display on the 
//Network, Directory screen. 
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No macro cell in specified range 


While preparing to test macros with //Macro, Analyze, range, Go 
you have specified a range in which there are no macros. Specify 
a range that contains macros. 


No macro names defined 


You've pressed ALT—F3 to display the Macro Name/Range 
Directory but no spreadsheets in memory contain named ranges 
that begin with a backslash. 


No matching record found 


No data in the current input block matches the specified criteria. 


No memory to release for COMMAND.COM 


You're using the /Quit, DOS command but there is not enough 
memory to run COMMAND.COM. Delete some files and try 
again. 


No more matching records 


The Find or Select operation has ended. 


No named ranges defined 


You pressed F3 to see the Named Range Directory, but there are 
no named ranges defined. 


No points to plot 


The data range for the graph must be defined. 


No points to plot; define Data range 


The data range for the graph must be defined — use 
//Graphics, Data. 
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No report type has been selected 


You are using the //Macro, Analyze, Go command but no report 
type has been selected. Select Type and choose one or more 
report types. Then select Go. 


No room for report 


Because of settings on the /Output, Printer or File, Options menu, 
there is not enough space on the page to print your report. 
Check the settings, especially margins. 


No unprotected cells in range 


You have selected //Restrict and have Global Tab on, which 
moves you directly to the next unprotected cell. However, you 
are in a restricted range containing no unprotected cells. 


No variable defined 


A variable range for the current graph has not been defined. One 
or more Data variables must be defined to produce a graph. 


Nonpositive numbers ignored 


In Pie graphs, negative numbers are not plotted. 


Not a square matrix 


Matrix must have same number of columns as rows. 


Not enough memory for add-ins 


There is not enough memory available in your current 
configuration to invoke or attach any add-ins. 
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Not enough memory for Fonts 2-8 


There’s not enough space available to load graph Fonts 2 through 
8. At least 9K of contiguous memory space is needed. Redefine 
all fonts to Font 1, or make more space available at the 

Global, Optimum menu or by deleting unneeded data in the 
spreadsheet. If the message persists, the reclaimed memory is not 
contiguous, so Save the file, Zap the spreadsheet, Load the file 
and try again. 


Not enough memory to justify 


You've selected a /Justify command, but your computer does not 
have enough internal memory for a copy of the range. To 
perform the justification, save the part of the spreadsheet you 
won't be justifying. Blank the part you've saved. Then perform 
the justification and reload the part you blanked. 


Not enough room for justify 


After justification, the new text won't fit back into the range 
specified. 


Not enough space for print file 


The server disk is full during print/graphics output redirection. 


Number too large 


The number you have entered is too large. Determine the 
acceptable range of values for this data and reenter. 


Numbers too large or small to graph 


The values used for Data points on your graph are too near the 
SuperCalc numeric limits (+ or - 1e-63 to 9.99999999999999€62). 
For example, the sum total of very large numbers used to define 
an area or stacked-bar graph might have exceeded the numeric 
limits. Adjust the values and retry. 
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Out of memory 


The computer’s memory is full. To maximize available memory, 
see /Global in Chapter 3 for memory optimization options. 


Output and Criterion ranges overlap 


The ranges specified for //Data, Output and //Data, Criterion have 
some of the same cells. Redefine one or the other, and try again. 


Output and Input ranges overlap 


The ranges specified for //Data, Output and //Data,Input use some 
of the same cells. Redefine one or the other, and try again. 


Output area full 


With //Data, Extract, there are more records that meet the criteria 
than can fit into output range. Enlarge the Output range. 


Output range cannot be single row 


The //Data, Output range must include field names in first row and 
at least one other row. The range is usually a block of partial 
rows. 


Output range not defined 


Before selecting //Data,Extract, or Select, you must specify the 
//Data, Output range. Or before using /Output, you failed to 
specify a range to output. 


Path not found 


Reenter the DOS path. Specify the correct drive and path 
designations. 
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Plotter not ready; correct and press any key. 


Make sure your plotter is on and ready to plot, then retry plotting 
your graph. 


Plotting... 
The program is preparing or plotting the specified graph. 


Print or disk redirection paused 


Another user has made the specified device inaccessible from the 
network (PC-Net only). 


Print queue full 


The printer's “waiting list” is presently full — try again in a few 
minutes. 


Printer out of paper 


You must load more paper in your printer to continue printing. 


Program disk/mode mismatch. F1 for help or CR 
to proceed. 


There is an incompatibility between your program mode (Fast or 
Data-space) and the disk. Either your program is set for Data 
mode, and you are using Fast mode disks, or you are trying to 
run Fast mode with insufficient memory. 


Program must be a .com file 


You're using the /Quit, To command to go to a file other than a 
.COM file (a .BAT file, for example). Make sure you use this 
command to go to a .COM file. 
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Protected data 


The data is protected. Unprotect the cell or use the Global,Protect 
toggle to temporarily turn off the shield of protection. 


Protected entry 


You're trying to enter data or formatting into a protected cell. To 
do this, you can turn protection off temporarily by using the 
/Global, Protect toggle. Or you can turn protection off 
permanently by using /Unprotect. 


Range error 


The cell range is not specified properly. Reenter the range. 


Range must be partial row or column 


SuperCalc requires a partial row or partial column range at this 
point. Reenter an appropriate range. 


Range outside spreadsheet boundary 


You have entered a range that lies beyond the current 
spreadsheet boundary. Reenter the range. 


Reading external names 


The program is loading the names of ranges beyond the current 
spreadsheet in order to display them. 


Redefines all synonyms 


The range name you specified already exists; if you enter a new 
range, it will redefine the range of all synonyms. 


Row error 


A single row entry is required. 
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Row range error 


The Row range is not specified properly. Reenter the range. 


Saving graphic file 


Informational message that appears when creating graphics data 
files. 


Search string not found 


You're in AUDIT mode, using the /Highlight, Find or /Replace 
command, and the string you're trying to find has not been found 
in the spreadsheet. 


SGn.OVL file not on program directory 


SuperCalc cannot find one of the graphics program files 
(SGC.OVL, SGD.OVL, SGE.OVL, SGI.OVL, SGL.OVL) necessary to 
graph — check your directory to make sure these files are 
present. 


Some data not exported 


Some data in the SuperCalc file you are exporting is not 
supported by earlier versions of SuperCalc. For example, 
columns beyond DW are not exported; text or formulas longer 
than 116 characters are truncated; and mathematical functions not 
supported by earlier versions of SuperCalc are converted into text. 
See Appendix C for more information. 


Some numbers offscale; redefine manual scaling 
min/max 


Redefine scale to include all values in Data range, or use 
automatic scaling rather than manual. 
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Spreadsheet modified; changes will be lost 


SuperCalc is reminding you to save your changes before giving 
the /Zap or /Quit commands. 


Spreadsheet name already defined in memory 


You have attempted to rename a spreadsheet using the name of a 
file that is already loaded into memory. 


SuperCalc program disk must remain in drive 


The disk containing the SC5.COM file must be in the appropriate 
drive. 


Table not defined 


You've pressed ALT—F9 to recalculate a table but you have not 
defined table ranges with //Data, Table. 


Target is within source range 


You specified a move that is inside the source range. 


Text truncated because too long 


SuperCalc shortened a text entry in an imported data file because 
the text exceeded SuperCalc’s maximum length of 240 characters 
for a text entry. 


This graph type needs two variables 


One variable is sufficient for Pie, Bar, or Line graphs; other graphs 
require at least two variables. 


Title cleared due to split window 


You have created a window that overlayed a title in your 
spreadsheet. As a result, the title has been cleared. 
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To start SuperCalc, log onto the drive and/or 
directory containing the program files and enter 
SC5. Or, use the DOS PATH command to access 
that drive/directory. 


You tried to begin SuperCalc from a drive or directory other than 
the one containing the SuperCalc program files. Either log onto 
the correct drive or directory, or use the DOS PATH command to 
set up a path to the directory containing SuperCalc. 


No room (at edge) to display window 


You have tried to issue a Window, Vertical command at the far left 
or far right column of the display, or a Window,Horizontal 
command at the first or last row of the display. You must begin 
the window at least one row above the last row showing on your 
screen (if horizontal), or at least one column to the left of the last 
column showing on your screen (if vertical). 


Too many data points; reduce 


Too many data points for the space available on-screen or on 
your plotting paper. Reduce the number of data points in your 
graph and retry. 


Too many links in spreadsheet 


You have attempted to establish links to more than 255 
spreadsheets at one time. 


Too many locked or open files 


You have exceeded the maximum number of open files. To 
increase this limit, see your DOS manual for instructions on 
increasing the FILES= parameter in the CONFIG.SYS file. If you 
are on a network, unlock a file and try again. This message may 
also appear when you are branching from within too many 
macros. 
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Too many points 


Too many data points for the space available on-screen or on 
your plotting paper. Reduce the number of data points in your 
graph and retry. 


Too many redirections 


Change your start-up parameters, or unlink another 
directory/printer not currently in use. 


Too many spreadsheets or pages 


You have attempted to exceed the limit of 255 pages or the limit 
of 255 spreadsheets loaded into memory at one time. 


Unable to calculate regression due to insufficient 
memory 


You're using //Data, Analysis, Regression but there is not enough 
memory to do the regression. Close some spreadsheets or blank 
some data and try again. 


Unable to reclaim release memory 


If you execute a program while temporarily in DOS, all the 
memory SuperCalc released may not be free upon your return to 
SuperCalc. This message appears. 


Undefined input range 


You are attempting to execute a command that requires an input 
range (i.e., //Data, Analysis, Regression or //Data,Find) before you 
have entered the input range. Enter input range, then try again. 
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Undefined search string 


You're in AUDIT mode and have tried to execute /Replace or 
/Highlight,Find but you haven’t specified a search string. If 
you’re using the /Highlight,Find command, select Contents or 
Value and then String. Enter the string. If you’re using the 
/Replace command, select the Old-string option and enter the 
string. 


File not loadable 


The file is not in SuperCalc 5.0 format (.cal file format). 


User abort at cell location 


You've pressed Ctrl Break to stop a command or calculation. 


User pressed CtriHbreak while macro being 
executed 


This message occurs if you press Ctrl-Break to abort while 
executing a macro. 


Value of pie total specified less than actual pie 
total 


The value you entered for the total pie size is less than the total of 
the points input to create the pie. 


Values with opposite sign treated as zero 


The values used to create a pie chart or stacked bar need to be of 
the same sign. SuperCalc will use the sign of the first point and 
treat all points with the opposite sign. 


Waiting to lock file. Press Ctrl-Break to abort. 


Another user on the network is currently reading this file, and 
SuperCalc must wait. 
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Windows/Titles cleared 


The program must clear the title or window setting to execute 
your current request. 


Windows/Titles restored 


Because of a change in the spreadsheet display, previously 
created windows or titles are now displayed again. This usually 
occurs when going from //Spreadsheet, Display,3 to //Spreadsheet 
Display,2 or 1. 
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Appendix B 
Troubleshooting: 
AUDIT Mode 


This appendix provides information on SuperCalc's auditing 
features, which are designed to help you create verifiable, error- 
free spreadsheets. 


AUDIT mode offers a variety of commands and functions that 
help you quickly spot possible trouble areas in your spreadsheet. 
You can highlight related cells, trace errors, or find and replace 
specific cell contents, then output results to a printer. 


This appendix is presented in two sections: 

m A discussion of how to use AUDIT mode to discover 
unreferenced data and examine relationships between cells in 
your spreadsheet. 


m A reference of each command and option. 


You may find it helpful to refer to the second section as you read 
the first. 


Using AUDIT Mode 


To reach AUDIT mode, select //Test or press Alt-F1. AUDIT 
replaces the standard READY mode indicator. 


The commands available under //Test let you: 
NW Locate unused data, or formulas using the wrong data. 


m View the spreadsheet in different display modes, to examine 
formulas or spot disruptions in data patterns. 
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Using AUDIT Mode 


NH Locate formulas that reference text cells. 

m Find formulas that reference empty cells. 

m Trace relationships between cells to track a final calculation. 
™ Look for all clones of a specific formula. 

m List any named ranges outside the spreadsheet boundaries. 

As you enter each test command, SuperCalc prompts you through 
the options available. You can see the results right on your 
screen. 

Because each test can be run independently or combined with the 
results of previous tests, there are an almost limitless number of 
tests available. The result of one test may call for a second test. 
As you run these tests, you may develop your own set of standard 


test sequences that you run for each new spreadsheet or after 
each major spreadsheet revision. 


The //Test Menu 


After selecting //Test, press / again to see the AUDIT mode menu, 
these options display: Highlight, Names, Replace, Squeeze, View, 
Details, Quit. 

Here’s a brief summary of these options: 

Quit returns you to the SuperCalc Ready mode. 

Details shows the results of the most recent Highlight test. 
Highlight locates specific cells based on your criteria, and 
highlights them on-screen. You can browse through them to 


check each individually. 


Names identifies ranges that may need closer examination, such 
as named ranges that are not referenced, or are reversed. 
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Using AUDIT Mode 


Replace lets you search for and replace text, formulas, control 
text, or numbers. 


Squeeze stores formulas as either originals or copies, and can 
reduce the amount of disk space your file requires. Squeeze 
should be executed prior to auditing, so that /Highlight, 
Relationships and /View, Map, Pattern can identify formula groups 
correctly. 


View offers different presentations of your data; Formula shows 
you the formulas behind your data, and Map shows data as 
unique patterns for formulas, text, macros, and numbers. 


Troubleshooting 


Testing for Unused Information 


You can search for data that doesn't feed into any formulas or 
totals. For example, you generally name a range to use the data 
in that range in a formula or function elsewhere in the 
spreadsheet. A named range that is never used may indicate 
incorrect spreadsheet results. 


You can use /Names, Unreferenced to locate all named ranges that 
are not used by any formula. The Named Range Directory — 
Unreferenced screen displays unused named ranges and their cell 
coordinates. For example: 


NAMED RANGE DIRECTORY UNREFERENCED 


Press ESC key to exit 
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Looking for Patterns and Groups 


Numbers, formulas, and text often appear in recognizable patterns 
within a spreadsheet. Formulas may appear in evenly spaced 
series of rows, numeric data may be contained in similar sized 
rectangular ranges, or text may precede every formula cell. Many 
formulas are part of a group that shares one original formula; 
these may also form a pattern. 


The View commands help you spot mistakes quickly, as 
disruptions of a pattern. 


To see your spreadsheet as a pattern of common elements, use 
/View,Map, Standard. This replaces cell contents with unique 
characters representing numbers, text/empty cells, formulas, and 
macros. 


The following characters represent specific types of data: 


" -Text and empty cells formatted at Entry level 


f - Formula 
# - Number 
m - Macro | = 
i - Invariant formulas 
| 


- Control text 


La ta 
+ AUDIT*E8 Form=7858 WS 
Width: 2 Memory: 58 Last Col/Row:048 

$> 


AUDIT Highlight Mames Replace View Quit 
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If you discover cells that do not match an obvious pattern, such 
as in our example, you can use /View, Map, Pattern to show 
relationships between the formulas. From this perspective, you 
can tell which formulas are unique and which are related. 


This mode uses characters to paint a picture of the formula 
patterns. Each group of formulas sharing the same original has a 
unique character. 


A 
A 
A 
A 
B 
C 


+ AUDIT*E8 Form=7858 
l 2 Memory: 58 Last Col/Row:048 


AUDIT Highlight Names Replace View Quit 


In our example, you can see a pattern in the formulas. One 
original formula has been copied over and over. But the pattern 
is broken in cell E8. In order to match the pattern, E8 should be 
a formula instead of a numeric constant. 


/View,Formula presents the formulas in your spreadsheet in an 
easy-to-read display. Because this information often takes up 
more space than the text and numbers you normally see, it shows 
you less of your spreadsheet, but in greater detail. Formulas often 
wrap within a cell. 
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TEMENT 
"Division A ¡"Division B ¡"Division C 
"Widgets 6200 1284 
"Gadgets 1898 1658 
"Bobb les 1568 3288 
'Whatsits 2000 1880 
"Prof it $ SUM (D4 : D7) 7858 


"Division A ¡"Division B ¡"Division C 
Widgets 6408 4780 1680 
"Gadgets 1968 1966 1858 
rc les 1658 1898 3584 
hatsits 2148 15688 2200 
"Profit SUM(C12:C15) ¡SUM(D12:D15) ¡SUM(E1Z:E15) 


"Division A ¡"Division B ¡"Division C 
"Widgets 6688 5188 2588 
> AUDIT*C8 Form=SUM (C4 :C7) 
Width: 14 Memory: 59 Last Col-Row:048 
1> 
AUDIT Highlight Manes Replace View Quit 


Use /View,Normal to return to standard spreadsheet display. 


Examining Formulas 


Formulas are an integral part of every spreadsheet. The 
/Highlight command lets you quickly identify all original 
formulas, all copies of one formula, each cell that one formula 
uses, or any unique formulas. 
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Use /Highlight, Relationships, Group, First to spot the first 
occurrence of each formula in the spreadsheet: 


"Division B ¡"Division € ¡"Division D 

4490 1208 SUH (WIDGETS) 

2188 1658 SUM(GADGETS ) 

1584 3200 SUM(BOBBLES ) 

988 1868 SUMCWHATSITS) 
E SUMCDA:D7?) 7858 ; SUMCPROFIT) 


"Division B ¿"Division C 

4788 1888 SUM(C12:F12) 

1988 1858 SUN(C13 -F13) 

1886 3568 SUN(C14 :F14) 

1588 2200 SUM(C15:F15) 

SUM(D12:D15) ¿¡SUM(E12:E15) ¡SUM(F12:F15) ¡SUM(G12:G15) 
SUM(YEAR 1987) 


"Division B ¿"Division C ¡"Division D ¡"TOTAL 
5188 ¿588 4588 III III SUM 


Press Spacebar (or select /Details) to display the Details window, 
which lists the highlighted cells and their contents: 


"Division B |"Division C 
44048 1200 
2109 1658 
1588 3200 
1898 
SUM(D4:D7) 7858 


TS) 
SUM (BOBBLES ) 
SUM CWHATS ITS) 


“TOTAL 
SUM(C12-F12) 


"Division D 
4898 


"Division C 
1898 


"Division B 
4789 


59 Last ColYRow :048 


Width: 14 Henory: 
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The top row indicates the number of cells highlighted by the last 
/Highlight command. 


Moving the cursor across the second row in the panel highlights 
each cell in the list, and displays its contents on the line below. If 
the cell list extends beyond the right margin, press Right Arrow 
to bring more cells into view. 


To examine a cell in the list, highlight the cell and press Return. 
The spreadsheet will adjust to display that cell. When you're 
done, press Esc to exit the list. 


Filtering Tests 


To closely examine one group of formulas, the original and each 
of its copies, move the cursor to the desired formula cell and 
choose /Highlight,Area, Filter, Current. This sets a filter, so that 
any subsequent /Highlight, Relationships, /Highlight, Cells and 
/Highlight,Find tests are based only on this cell. 


To highlight all cells that match this cell, choose /Highlight, 
Relationships,Group,All. If the current cell contains a formula, all 
cells that are copies of that formula will be highlighted. Here’s an 
example of highlighted matching formulas: 


"Division B ("Division C |"Division D |"TOTAL 
44668 1268 4308 SUM (W IDGETS ) 
2180 1658 1588 SUM(GADGETS ) 
1588 3208 2700 SUMCBOBBLES ) 
11888 SUM(WHATSITS ) 
17858 S SUMCPROFIT) 
SUMCYEAR 1986) 


"Division "Division C ("Division D ("TOTAL 

4700 1868 4880 SUM(C12:F12) 
1998 1858 1898 SUM(C13:F13) 
1888 3508 2658 SUM(C14:F14) 


"Division B "Division C ¡"Division D |"TOTAL 
- 15100 2500 4500 SUM(C28 :F20) 
2358 1868 3584 SUM(C21 :F21) 
1854 3 : 
+ AUDIT*C8 Fo 
Width: 14 Memory: 59 Last ColYRow : (148 
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Often when you run this test, entire rows or columns will be 
highlighted. If one cell in a row or column is not highlighted, it’s 
best to review it’s contents for accuracy. 


After running a test, a message displays the number of cells the 
test uncovered. 


To remove the test filter so that all cells are considered again, 
select /Highlight, Area, Filter, All. 


Unique Formulas 


Another test locates all formulas that are unique (they are not 
copies of another formula nor the parent of copied formulas). 
Select /Highlight, Relationships, Group, None. 


Every formula which is neither a copy of another formula nor the 
parent of any copied formulas is highlighted; they have no 
matches in the spreadsheet. 


AR: OR | Te a | Se ee | ES Se © 


4th Grade 
school # of Students 


Sinwood 68 
Peters 83 


4th Grade Sth Grade 6th Grade 
t of Students t of Students # of Students 
Total 151 112 135 


Total Students 
4th, Sth 4 6th 


‘i 
ad 


se 
1 SCHOOL A17 za 
Width: 15 Memory: 66 Last Col/Row 


At this point, you can examine the cells that are used by a unique 
formula, by selecting /Highlight, Area, Filter, Highlighted, then 
/Highlight, Relationships, Supporting, Direct. 
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This highlights each cell that feeds directly into the highlighted 
formula. For example, if a highlighted cell contained the formula 
B12+C12+D12, the cells B12, C12, and D12 would be highlighted. 


if age E p E y E re 
A CA 
HE eet E de E at E Aa 


4th Grade 
school # of Students 


Erem: 


Simvood 68 
Peters 83 


4th Grade Sth Grade 6th Grade 
iat X of Students # of Students # of Students 
otal 


pont -- a- 5-9-5 4 na 
EA m 2. = 


i 
i 
' 
| 


Wii Total Students 
ii 4th, Sth & 6th 


F T 
Width: 15 Memory: 66 Last Col-Rou : 
1> 


This lets you verify that all cells that should go into a result are 
accounted for. You may want to use /View, Formula for a closer 
look at the referenced cells, or /View,Map to see the pattern of the 
contributing cells. 


Nested Relationships 


You can also highlight cells that indirectly feed into a formula. For 
example, if B12 contains the formula B7+B8, the contents of B7 
and B8 contribute to the result in B12 as well as any cells that 
contribute to the result in B7 or B8. 
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To view these contributing cells, put the cursor on the cell you 
want to indirectly trace and choose /Highlight, Relationships, 
Supporting, Nested. 


4th Grade 
school 8 of Students 


Simwood 
Peters 


4th Grade Sth Grade 6th Grade 
E of Students # of Student 
Total 


Total Students 
4th, Sth & 6th 


ZH Hii 
3 SCHOOL !A17 Form 
Width: 15 Memory: 66 Last ColYRow:H17 


Finding Circular References 


/Highlight, Relationships, Circ can help you to locate and examine 
circular references in your spreadsheet. 


Combining Test Results 


The tests described earlier automatically cleared all highlights 
before proceeding to the next test. If you like, you can 
simultaneously view the highlights from two or more separate 
tests. 


The command /Highlight, Pre-zap, No lets the result of each test 


build on the previous ones. To perform independent tests again, 
choose /Highlight, Pre-zap, Yes. 
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Watching the Effects of Recalculation 


With the /Highlight,Modified, Yes command, you can highlight 
each cell that is recalculated. When you leave AUDIT mode and 
revise your spreadsheet, all cells affected by the recent 
recalculation will be highlighted. 


Test Reports 


You can print Audit test results with Supercalc’s /Output 
command. A spreadsheet report in the currently selected View 
mode can be obtained with /Output,, Options, Report, Contents, 
View. A report on currently highlighted cells can be generated 
with /Output,, Options, Report, Contents, Highlighted. 
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Audit Commands 
Use Alt—F1 or //Test to reach Audit mode. 


/ - Details 
Highlight, — Area, Filter, All 
Current 
Highlighted 


Not-highlighted 
Range,range 
Block, range 
Cells, Attribute 


Blank-ref 
Constant 
Date 
Error 
Formula 
Hidden 
Invariant 
Lone 
Macro 
NA 
fOrmat 
Protected 
Referenced 
String 
Time 
Unprotected 
emptY 
Find, Contents, — Go 
Case, Any 
Exact 
Labels, Yes 
No 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Relation, Koap 
Not-equal 
String,string 
Quit 
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ae Numbers, — Go 
Relation, - Equal 
Not-equal 
Above 
Below — 
Greater/equal 
Less/equal 
Value, value 
Quit 
Text, Go 
Case, Any 
Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Relation, a 
Not-equal 
String,string 
Quit 
Links, Dependent 
Modified, Yes 
No => 
Output-attr, All 
Border, All 
Top 
Bottom 
Left 
Right 
Fonts, All 
1 
2 
3 
4 
5 
6 
7 
Shade 
Pre-zap, Yes 
No 
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Supporting, p Direct 


Relationships, Circ 
Dependent, - Direct 
Nested 
Group, All 
- First 
None 


Nested 
Zap 
Names, Bounds 
Duplicate 
Overlap 
Reversed 
Unreferenced 
Replace, Go 
Range,range 
Old-string,string 
New-string,string 
Case, Any 
Exact 
Match, Begins 
Contains 
Exact 
Terminates 
Word 
Prompt, - Yes 
No 
Labels, Yes 
No 
Quit 
Squeeze 
View, Normal 
- Formula 
Map, Pattern 
Standard 
Quit 
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/Highlight 
These commands locate and highlight specific cells based on your 


criteria. A message indicates the number of cells the test 
highlighted. 


After selecting /Highlight, these options display: Area, Block, Cells, 
Find, Links, Modified, Output-attr, Pre-zap, Relationships, Zap. 


/Highlight,Area 


Lets you limit the area of the spreadsheet on which tests are 
performed, and select cells on which to base tests. It does not 
actually highlight the cells. 


/Highlight, Area, Filter 


Lets you select the cells on which to base tests. Select from the 
options, or use Alt-F1 when in /Highlight to toggle these filters. 
The mode indicator at the lower left of your screen will reflect the 
current filter: 


Filter Mode Cells on which 

Option Indicator to Base Tests 

All AUD-A All cells 

Current AUD-C The current cell 

Highlighted AUD-H Currently highlighted 
cells 

Not-highlighted AUD-N Cells not highlighted 

/Highlight, Area, Range 


Limits tests to the cell range you specify. The default range is the 
active spreadsheet. 


/Highlight,Block 


Highlights the specified range. This highlighted block can then 
be used as the basis for further tests with the filter set to AUD-H 
(highlighted) or AUD-N (not highlighted). SuperCalc does not 
remember the range. 
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/Highlight,Cells 


Highlights any cell that contains the type of contents specified. 
You can use /Highlight, Area, Range to limit the range for testing. 


To highlight cells that meet all of two or more conditions, first 
highlight one of the cell conditions, then set filter to AUD-H, and 
continue to test for other conditions. 


For example, to highlight all protected formulas, first select 
/Higblight, Cells, Formula. All cells which contain formulas are 
highlighted. Next, select /Highlight, then press Alt-F1 until the 
filter on the help line shows AUD-H (highlighted). Only currently 
highlighted cells will be used for subsequent tests. 


Then, continue with Cells,Protected. The currently highlighted 
cells (cells that contain formulas) are tested, and those that are 
protected are highlighted. Only cells that both contain formulas 
and are protected will be highlighted. 


You can also highlight cells that meet any one of two or more 
conditions by selecting /Highlight, Pre-zap, No. 


For example, to highlight all protected cells and all cells that 
contain formulas, choose /Highlight,Pre-zap,No, then /Highlight, 
Cells, Formula. All cells which contain formulas are highlighted. 
Next, select /Highlight, Cells,Protected. The previous highlights 
remain and in addition, all protected cells (formulas or not) are 
highlighted. 


You can highlight cells with the following types of contents: 


Attribute Cells that contain control text 
Blank-ref Cells that contain formulas which reference 


blank cells (no data, no entry level formatting) 
Constant Cells containing numeric constants 


Date Cells that result in a date 
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Error 


Formula 


Hidden 


Invariant 


Lone 
Macro 


NA 


fOrmat 
Protected 
Referenced 


String 


Time 


Unprotected 


empty 


Cells of a formula that contain ERROR or 
result in ERROR 


Cells that contain formulas which are not 
Invariant 


Cells hidden at entry level 

Cells containing formulas or functions whose 
value never changes. These may be formulas 
created with only values and operators, no 
cell references (such as SUM(6,5), or 8*7). 
Also highlights ERROR and N/A. Does not 
highlight constants. 

Cells not referenced by another cell 


Cells with the first character / or { 


Cells with formulas that contain or result in 
N/A (not available) 


Entry level formatted cells, empty or not 
All protected cells 
Cells referenced by another cell 


Cells that contain text or result in a string 
value 


Cells that result in a time 
All unprotected cells 


Cells formatted at entry level but containing 
no data 
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/Highlight,Find 
Finds and highlights cells based on cell values or contents. You 


can use /Highlight,Area,Range and Filter to limit the range and 
cells for testing. 


/Highlight, Find, Contents 


Lets you search formula and text contents to locate and highlight 
cells which meet specified conditions. The options are: Go, Case, 
Labels, Match, Relation, String,and Quit. 


Go Executes the search 
Case Specifies if the search is case-sensitive. 
Z Exact — Searches on a case sensitive 
basis 


a Any — Ignores case 


Labels Specifies whether the search string will 
contain cell references or named ranges. The 
default is Yes. 


ES Yes — Recognizes formula references 
in the search string as named ranges. If 
you enter the search string SUM(A1), 
SuperCalc will interpret A1 as the name 
of a range. 


x No — Recognizes formula references in 
the search string as cell references. If 
you enter the search string SUM(AD), 
SuperCalc will interpret A1 as the cell 
reference Al. 
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Match Specifies where the specified string must 
occur in the cell contents: 


E Exact — Entire cell contents ("Apple 
finds the text Apple but not the text 
Apple and Pears.) 

a Contains — Anywhere within the cell 
(lie finds applied) 

€ Begins — At the beginning of a larger 
string ("sam finds sample) 

z Terminates — At the end of a larger 
string (end finds spend) 

# Word — A “whole word” within the 
contents (Quarter finds First Quarter 
Results but not Quarterhorse) 

Relation Find cells that match the string (or those 


which do not match): 


fe Equal — Highlights cells that match 
the entered string 
& Not-Equal — Highlights cells that do 
not match the entered string 
String Prompts you to enter the string you wish to 
search for 
Quit Returns to AUDIT mode 


/Highlight, Find, Value 


Searches value of cells for text or numbers, to locate cells which 
meet your criteria. Searches only for formula results or direct 


entries, not the formulas themselves. 
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/Highlight, Find, Value, Numbers 

Searches values of cells (formula results or direct entries) for the 
value you specify. Highlights cells that meet the selected type of 
relation. The options are: Go, Relation, Value, and Quit. 

Go Executes the search. 

Relation Highlights cells whose values are: 


Z Equal — Equal to specified value 


2 Not-equal — Not equal to specified 


value 
z Above — Greater than specified value 
E Below — Less than specified value 
E Greater/equal — Greater than or 


equal to specified value 


Ed Less/equal — Less than or equal to 
specified value 


Value Prompts you to enter the value to search for. 
This can be an expression resulting in a 
numeric, date or time value. 


Quit Returns to AUDIT mode. 


/Highlight, Find, Value, Text 


Searches values (formula results or direct entries) of cells for the 
text string you specify. The options are: Go, Case, Match, 
Relation, String, and Quit. 


The options are the same as for /Highlight, Find, Contents, except 
that the search is for cell values instead of contents. 


Troubleshooting: AUDIT Mode B-21 


AUDIT Commands 


The string can be an expression; you can include cell references. 
For example, the string A1 will be recognized as cell A1; to search 
for the characters Al, first enter a quotation mark ("A1). You can 
also search for named ranges. 


Go Executes the search = 
Case Searches case-sensitive or not: 
A Exact — Searches on a case sensitive 
basis 


= Any — Ignores case 


Match Specifies where the specified string must 
occur in the cell contents: 


= Exact — Fntire cell contents (Apple 
finds Apple) 


8 Contains — Anywhere within the cell 
(lie finds applied) 


3 Begins — At the beginning of a larger 
string (sam finds sample) 


g Terminates — At the end of a larger 
string (end finds spend) 


i, Word — A “whole word” within the 
contents (Quarter finds First Quarter 
Results) 


Relation Finds cells that match (or do not match) the 
search string: 


= Equal — Highlights cells that do meet 
the specified conditions 


mE £Not-Equal — Highlights cells that do not 
meet the specified conditions 
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String Prompts you to enter the string you wish to 
search for. This can be an expression resulting 
in a string value. 


Quit Returns to AUDIT mode 


For example, a search for FRED will highlight cells containing a 
string function that results in FRED as well as any cell containing 
the text FRED. It will not highlight a formula that contains FRED 
but does not result in FRED. Therefore, of the following cells, F5 
and G5 would be highlighted, but M8 would not: 


F5 contains the text FRED and returns FRED. 
G5 contains LEFT(‘FREDRICK”,4) and returns FRED. 
M8 contains RIGHT(‘FRED”,2) and returns ED. 


/Highlight,Links, Dependent 


Highlights all cells that contain references to another spreadsheet. 


/Highlight,Modified 


Controls whether cells affected by recalculations are highlighted, 
regardless of whether you are in AUDIT mode. /Highlight, 
Modified, Yes will highlight recalculated cells. /Highlight, 
Modified,No turns off the highlighting feature. 


/Highlight,Output-attr 


Highlights cells that have been assigned attributes with the 
/Output command. These tests help you check the expected 
printer output on screen. The options are: All, Border, Fonts, and 
Shade. 


You can use /Highlight,Area, Range to limit the range for testing. 
/Highlight, Output-attr, All 


Highlights all cells that have any attributes defined (fonts, border, 
or shade). 
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/Highlight, Output-attr, Border 
Highlights cells assigned borders with /Output, Attributes, Border. 


All Cells with any border 

Top Cells bordered on the top 
Bottom Cells bordered on the bottom 

Left Cells bordered on the left 

Right Cells bordered on the right 


/Highlight, Output-attr, Fonts 


Highlights cells assigned fonts with /Output, Attributes, Fonts. 
All Cells assigned any font 


1 to 7 Select individual fonts by number to highlight 


/Highlight, Output-attr, Shade 
Highlights cells assigned shading with /Output, Attribute, Shade. 


/Highlight,Pre-zap 


/Highlight, Pre-zap, Yes clears all highlights before each new 
/Highlight command is executed. /Highlight,Pre-zap,No lets you 
add highlights of each new test to the highlighted cells from 
previous tests. This option lets you combine tests to check 
multiple criteria. 


/Highlight,Relationships 


These commands let you search for relationships between cells 

with formulas only. You can use /Highlight, Area, Range to limit 

the range for testing, and Alt-F1 (toggles the filter at /Highlight) 
to specify which cells within that range to use as the basis for the 

test. 
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AA A a a ea 


The options are: Circ, Dependent, Group, and Supporting. 


/Highlight, Relationships, Circ 


Highlights the circular references in the spreadsheet. 


/Highlight, Relationships, Dependent 


Lets you search for the cells used (referenced) by a cell or group 
of cells. 


Direct Highlights only those cells which directly use 
the selection 


Nested Highlights cells directly referenced, as well as 
cells that use those cells, and the cells used by 
those cells, and so on. 


Example: 


Al contains B1+B2 

B1 contains B3-B4 

B3 contains a constant, and 
B4 contains Cl. 

C1 contains 5. 


With C1 as the current cell and the filter set to current (AUD- 
C), /Higblight, Relationships, Dependent, Direct highlights cell 
B4. This cell is directly dependent on C1. 


/Highlight, Relationships, Dependent, Nested highlights cells B4, 
B1, and Al. B4 depends on C1, B1 depends on B4, and Al 
depends on B1. B3 is not dependent on any other cell. 


/Highlight, Relationships, Group 


Highlights groups of cells. A formula group includes the original 
and all copies of the formula. 


All Highlights all cells of the same group within 
defined area. 
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First Highlights each “parent” formula found first in 
a row-wise search from upper left of the 
sheet. 

None Highlights all formulas that are unique; that 


have no matches in the spreadsheet. 


/Highlight, Relationships, Supporting 


Lets you search for those cells which support a cell or group of 
cells. 


Direct Highlights only those cells which directly 
support your selection 


Nested Highlights the cells containing the directly 
supporting cells, as well as the cells that 
support those directly related cells, and the 
cells supporting those cells, and so on. 


Example: A1 contains B1+B2 
B1 contains B3-B4 > 
B3 contains a constant, and 
B4 contains C1. 


With A1 as the current cell and the filter set to Current, 
/Highlight, Relationships, Supporting, Direct highlights cells B1 and 
B2. Both directly support Al. 


/Highlight,Zap 
Clears all cell highlights. 


/Names 


/Names lists the ranges that meet specified conditions. By 

examining these ranges, you can determine if an error exists. The 
options are: Bounds, Duplicate, Overlap, Reversed, and == 
Unreferenced. 
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When you have finished viewing the current test’s results, exit the 
display window by pressing Esc. 


/Names,Bounds 


Informs you of named ranges whose range definitions include 
cells beyond the spreadsheet’s active range. The active range is 
the area actually used by your formulas and data. Displays the 
Named Range Directory — Bounds screen. 


/Names,Duplicate 


Tests for the condition where identical groups of cells are given 
different range names. As you scroll through the list on the left, 
the duplicate names will be displayed on the list on the right. Use 
TAB to move from one column to the other. Displays the Named 
Range Directory — Duplicate screen. 


/Names,Overlap 


Tests for ranges which share some or all of the same cells. 
Selecting this option brings up one screen, with two columns. As 
you scroll through the list on the left, the overlapping ranges will 
be listed on the right. Use TAB to move from one column to the 
other. Displays the Named Range Directory — Overlap screen. 


/Names,Reversed 


Lists the named ranges in which the lower right coordinate of the 
range is put before the upper left, (non-normalized). For 
example, if the range named YEAREND was specified as G12:D9 
(lower right:upper left), it is considered reversed. This selection 
displays the Named Range Directory — Reversed screen. 


/Names,Unreferenced 


Lists named ranges that are not used by any formula in the 
spreadsheet. Displays the Named Range Directory - Unreferenced 
screen. 
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/Replace 


Use the /Replace command to look for text, control text, formulas, 
or numbers to replace with other data. The options are: Go, Case, 
Labels, Match, New-string, Old-string, Prompt, Range, and Quit. 


When using /Replace to replace numbers, it’s best to choose 
Match,Exact and Prompt. For example, if you enter 10 as the 
Old-string without specifying /Replace,Match,Exact, you might not 
only replace each instance of 10, but each instance of 100 (the 10 
within 100) with the new string. Specifying Prompt ensures that 
each replacement is valid, and your data is not compromised. 


/Replace,Go 


Choose Go when you are ready to begin the replacement. 


/Replace,Case 


Searches can be case sensitive (Case, Exact) or not (Case, Any). 


/Replace,Labels — 


Specifies whether New-string will contain cell references or 
named ranges. The default is Yes. 


Labels, Yes recognizes formula references in New-string as named 
ranges. If you enter the string SUM(A1), SuperCalc will interpret 
Al as the name of a range. 


Labels, No recognizes formula references in New-string as cell 
references. If you enter the string SUM(A1), SuperCalc will 
interpret Al as the cell reference Al. 


/Replace,Match 


You may also choose to search for an occurrence of the string 
within a larger string (Match, Contains), a “whole word” 
occurrence (surrounded by spaces) of the string (Match, Word), 
the occurrence at either the beginning or end of the larger string 
(Match, Begins or Match, Terminates), or only the entire cell 
occurrence (Match, Exact). 
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/Replace,New-string 


Prompts you to enter the replacement string. After replacement, 
the cell type remains the same as it was previously. 


Example: 


The new string ERROR replaces the old string TRUE. If TRUE is a 
formula in a cell, then ERROR is placed in the cell as a formula. If 
TRUE is in a cell as text ("TRUE), then ERROR is placed in the cell 
after the quote (ERROR) as text because the quote was not 
included in the old string to be replaced. 


/Replace,Old-string 


Prompts you to enter the string you wish to replace. Searches for 
the string in contents of cells. The string could be any part of any 
formula, text, numbers, or control text. 


/Replace,Prompt 


You may also choose to accept or reject each replacement 
individually (Prompt, Yes) or have the replacement continue 
automatically without asking for confirmation (Prompt, No). 
/Replace,Prompt, Yes offers the choices Yes, No and Remaining at 
each match (Remaining replaces the remaining cells without 
asking). 


/Replace,Range 


Limits the area of the spreadsheet for search and replacement. 


/Replace,Quit 


Leaves the menu, but does not leave AUDIT mode. 


/Squeeze 


Squeeze notes the first occurrence of any formula (the original or 
“parent”) in the spreadsheet and stores all subsequent occurrences 
of the identical formula as references to the original. This can 
reduce the memory required by your spreadsheet. 
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You should use this command before auditing your spreadsheet. 
/Squeeze is important to use before selecting /Highlight, 
Relationships, Group and /View,Map, Pattern. 


Formulas duplicated by /Copy are already stored in this manner 
by SuperCalc. After using Squeeze, each formula on the 
spreadsheet is stored as either the original or a copy, whether the 
copy was generated with the /Copy command or entered directly 
into the spreadsheet. 


/View 


/View lets you display the spreadsheet in different ways. Each of 
these display modes lets you see your spreadsheet formatted in a 
special way and can help you to quickly locate patterns and 
exceptions. 


While the normal spreadsheet mode is the optimum display mode 
for judging the appropriateness of cell relationships in your 
spreadsheet, the other modes provide a close-up or distant 
perspective that can aid in troubleshooting. 


The mode you select remains in effect as you execute Audit 
commands and returns to normal display when you leave Audit 
mode. If you quit and then re-enter Audit mode, the spreadsheet 
will display in the last selected View mode. 


You can print the spreadsheet in the currently selected View 
mode with the SuperCalc command 
/Output,, Options, Report, Contents, View. 


Selecting /View displays the following options: Formula, Map, 
Normal. 


/View,Formula 


Lets you see the formulas behind your data. Because formulas 
usually take more space than their results, Formula automatically 
adjust up to a maximum column width of 20 characters; large 
formulas and text will wrap within the cell. If the next cell to the 
right is blank, text will overlap; formulas will wrap. 
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This view forces full screen window if you've split the display 
with /Window, but you'll return to the split window once you 
return to Normal View. 


/View, Formula will display cell or range names, depending on the 
/Global, Labels setting. 


/View,Map 


Represents data as unique characters, giving you a highly 
condensed view of your spreadsheet. You can see more of your 
spreadsheet, in less detail. As you perform highlight tests, the 
results form easily identified patterns. 


We recommend that you use /Squeeze before using map view. 


The following characters are used to represent data: 


" -- Text and empty cells 


f - Formula 
# - Number 
m - Macro 


Two versions of Map are available. 


/View,Map, Pattern 


Uses special characters to paint a picture of the formula patterns 
in your spreadsheet. Each group of formulas sharing the same 
original has a unique character. 


/View,Map, Standard 


Replaces your cell contents with the above noted characters 
which represent numbers, text and empty cells, formulas, and 
macros. 


/View,Normal 


Returns to normal spreadsheet display. 
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/Details 


Presents a detail window on screen of all cells currently 
highlighted from the most recent /Highlight test. The detail 
window can also be accessed with Spacebar. 


The top portion of the box lists the cell addresses of the 
highlighted cells. As you scroll through these addresses, their 
contents display in the lower portion of the box. 


The top row indicates the number of cells highlighted by the last 
/Highlight command. Moving the cursor across the second row in 
the panel highlights each cell in the list and displays the cell’s 
contents on the line below. If the cell list extends beyond the 
right margin, press Right Arrow to bring more cells into view. 


Pressing Return with the cursor on a cell address places the 
spreadsheet cursor on that cell, and centers it in the display. 


/Quit 


Exits Audit and returns you to SuperCalc READY mode. 
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Appendix C 

Notes for Users of 
Previous SuperCalc 
Versions 


This appendix summarizes features introduced with the latest 
version of SuperCalc as well as compatibility issues between this 
version and prior releases. 


See Chapter 2 for details about commands described in this 
appendix. 


New Features 


m Faster, more intelligent recalculation: 


Minimal recalculation feature reduces time necessary for 
recalculations. SuperCalc knows which cells need 
recalculation and only those cells are recalculated. Prior 
versions recalculated every cell in the spreadsheet. 


New command, /Global, Evaluation, Range, lets you 
specify the range for recalculation. 


m Enhanced graphics presentation, including many new two- 
and three-dimensional chart types. 


m Enhanced compatibility with other software: 


Use actual Lotus 1-2-3 command sequences and switch 
between SuperCalc or Lotus mode, on a global or one- 
time basis. 


Now, you can directly load Lotus 1-2-3 files through the 
/Load command. In earlier versions you had to use 
//Import. You can also save a spreadsheet to Lotus 1-2-3 
format with /Save, you no longer need to use //Export. 
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New Features 


- Import and export dBase III files. 

- Two sets of screen colors are available for best display 
with memory resident programs that set screen colors and 
cause blinking. 

m New Undo feature takes back the last command or data entry 
and restores the spreadsheet to its previous condition (see 

/Global, Optimum, Chapter 2). 


m New formulas, functions (see Chapter 3): 


- 20 new string functions for manipulation of text in 
formulas. 


- Other new functions, including time. 


- Computed cell references allowed in formulas and 
commands. 


m New command, //Spreadsheets, (see //Spreadsheets in 
Chapter 2) provides global control of open spreadsheets, so 
you can: 


- Keep multiple spreadsheets in memory at one time. 


- Link data from one spreadsheet to another in memory or 
on disk. 


-  /Insert, /Delete, /Move, and /Zap now have options for 
working with individual pages, and /Load and /Save have 
options for specifying a single spreadsheet (when 
multiple spreadsheets are in memory). 

- Point from one spreadsheet to another in memory. 

m@ New entry and edit features: 


-  Tramspose rows and columns during /Copy and /Move. 


- /Edit and /Copy across spreadsheets. 
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- Enter destination cell for /Edit. 


- Use /Format,HideColumn to set column width to 0; the 
cursor will skip that column. 


-  /Blank now lets you blank a cell's contents without 
changing its entry level formats. 


-  /Arrange,Block allows a third sort key; more available 
through nested sorts. 


- There is now a confirmation prompt when deleting a file. 


Time values and time format options now offer a 12-hour or 
24-hour clock, user-defined formats, and time functions. 


New /Justify, Word-wrap option facilitates text entry. 


New command, //Add-in, accesses add-in programs and 
functions for increased functionality. 


Enhanced macro capabilities (see Chapter 4): 
- New commands, including {FOR} to implement loops. 


- New menu options for debugging SuperCalc macros and 
converting Lotus 1-2-3 macros to SuperCalc format. 


New option, /Quit,DOS, lets you temporarily exit to and use 
the operating system. 


New /Output options to support laser printers and some dot 
matrix printers. With enhanced output options, you can: 


- Set output device attributes by selecting from device 
menu. New attributes include type pitch, print quality, 
character translation table, and reset sequence. 


- Embed page ejection commands in spreadsheet. 


- Place setup strings and current filename within headers 
and footers. 
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New Features 


Choose form feed or line feed for page ejection. 
Set font attributes for cells and ranges. 


Border Outline, Shade, or Grid cells and ranges in 
reports. 


Select up to four serial ports to take full advantage of 
DOS 3.3 capabilities. 


Insert non-printing comment lines within a print range. 


Save and load separate default configuration files to quickly 


change settings for any spreadsheet. 


New //Data management and analysis options: 


Delete command to remove selected records. 


Analysis provides frequency distributions and regression 
analysis. 


Block fills a range with linear or geometric numbers or 
date labels. 


Matrix allows operations on matrixes for multiplication, 
inversion, and solution of 90-variable simultaneous 
equations. 


Parse splits combined data into separate fields. 


Table creates 1- and 2-variable “what-if” tables. 


m New /Format, User-define, Number, Minus, Float, allows 
parentheses for negative numbers to float with the size of the 
value. 


m@ New command, /Global, Values, displays global settings on 
screen. 
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m SuperCalc offers large screen support. You can toggle 
between large and standard screen views using /Global,Zoom. 
Screen drivers are available from video board manufacturers. 


m Network handling is enhanced to allow more than 16 files to 
be locked at the same time. 


m= New command, /Name, Table, creates a list of defined named 
ranges. 


m New commands /File, Path and //File,Directory, let you guide 
automatic file searches. 


m File List displays when incomplete or ambiguous filename is 
specified. 


m SuperCalc supports up to 32MB of expanded memory using 
the LIM 4 specification. 


NH Optional auditing features help track errors, search for cell 
value, content, format or type, and search and replace items 
(see Appendix B). A /Squeeze option saves memory and disk 
space by eliminating formula duplication. 


Compatibility with Prior Releases 


The SuperCalc file format has been modified to save chart 
descriptors, spreadsheet links, and string functions. These 
modifications result in the following compatibility issues: 


m Upward compatibility: Existing .cal files from previous 
versions can be loaded into the current version of SuperCalc. 


= Downward compatibility: Files must be saved to previous 
SuperCalc versions using /Save, Level. 
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Compatibility with Prior Releases 


Topics Describing Current and Prior 
Releases 


These sections compare current and previous SuperCalc versions 
in-more detail: 


NW Commands and Options 
New Functions 
Other New Features 


Hidden Options 


Compatibility Details 


Commands and Options 


See Chapter 2 for more details. 


Command changes are listed in alphabetical order, without regard 
to the single or double slash preceding the command entry. 


E //Add-in allows access to the supplemental program support 
menu. 


/Arrange now allows a third sort key. 
/Blank lets you blank cell contents without changing formats. 
NW /Copy can transpose rows and columns and vice versa. 
E //Data includes data distribution and regression, fill by 
number and date, parsing, matrix operations, and “what-if” 
tables. 


Mm /Edit accepts a destination cell. 


E /Load searches for .wk1 files first, then .wks files if no .cal file 
is found. 


= //Export no longer visibly offers SuperCalc3 or 1-2-3 options 
(although they remain as hidden options). Export to previous 
SuperCalc versions now with /Save, Level. /Save now saves 
Lotus 1-2-3 files also. 
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/Format,HideColumn sets column width to 0 and cursor skips 
these columns. 


/Format, User-defined now offers time formats. 


/Global, 1-2-3 enters Lotus mode on a global basis for using 
Lotus command sequences. 


/Global, Optimum now offers Present and Next defaults. 


/Global, Evaluation, Range limits area of spreadsheet for 
recalculations. 


/Global, Keep lets you save and load your personal program 
settings. 


/Global,Labels displays the named range in a formula. F7 can 
be used to toggle range labels versus range references when 


editing formulas. 


/Global, Spreadsheet, /Global, Graphics, and //Graphics, Global 
allow selection of up to 4 serial ports. 


//Graphics replaces the command /View and adds many new 
features. 


//Import lets you specify criterion for importing specific 
records in dBase III files. 


/Justify, Word-wrap offers text entry features. 


/Load supports multiple spreadsheets and direct loading of 
Lotus 1-2-3 .wk1 and .wks files. 


/Move allows transposition of rows and columns. 


/Name, Table creates a list of currently defined named ranges. 
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E /Output offers a number of changes, including: 
- Default for borders is changed from Auto to No. 


- — New header/footer options: ef prints the filename, el 
prints the long filename; @p prints the page number. 


- Setup string length is increased to 240 characters. 


- New option, Spool, to send or not send setup string when 
printing to disk. 


NW New /Output commands let you modify printer fonts, add 
boxes and rules, and shade cells. 


E /Output, Options, Initialization sets the type quality, character 
pitch, and print orientation. 


E /Output,New-page inserts a page break and ends the current 
page with the preceding line. 


m  /Output Printer, Width and /Output, File, Width returns the 
width, in characters, of the requested range. 


m //File,Path lets you specify a search path for file read 
functions. 


E /Quit,DOS temporarily returns you to the operating system. 
Typing Exit returns you to current SuperCalc spreadsheet. 


Mm /Save,Level exports spreadsheet to previous SuperCalc 
versions. 


E /Save,Mode determines the cells that will be saved: AH, 
Protected, or Unprotected. 


m //Spreadsheets provides global control of multiple 
spreadsheets in memory. 


= /Worksheet,Global,SC5 returns to SuperCalc from Lotus mode 
(see /Global, 1-2-3) 
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m /1-2-3 interprets the next individual command sequence as a 
Lotus 1-2-3 command. 


m //Test offers an AUDIT mode for tracking spreadsheet errors 
and searching for values and formulas. It also offers search 
and replace commands. 


æ Alt—F3 displays a table of all named ranges beginning with 
the \ character (usually macros). 


New Functions 

See Chapter 3 for description and examples of the new functions. 
NH New logical functions: ISPROT, EXACT. 

m New index functions: ADDRESS, CURSHEET, N, S, CURPAGE. 


m New calendar functions: TIME, DATEVALUE, HOUR, 
MINUTE, NOW, SECOND, TIMEVALUE, TVAL, ISTIME, JTIME. 


New arithmetic functions: ROUNDUP, TRUNC. 


New string functions: CHAR, CODE, CONTENTS, DISPLAY, &, 
FIND, LEFT, LENGTH, LOWER, MID, PROPER, REPEAT, 
REPLACE, RIGHT, STRING, TRIM, UPPER, EXACT. 


NW New special-purpose functions: FORMAT, TYPE, VALUE, 
WIDTH, €. 


Other New Features 


m SuperCalc prompts for confirmation of file deletion; 
/Delete, File will prompt Yes/No. SuperCalc4 required only a 
Return to execute the command. 


Mm /Edit and /Blank cannot be terminated with a comma; you 
must press Return. This may cause incompatibilities in 


macros. 


m The operator “ = ” is now case insensitive: “dog” = “Dog.” 
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A cell referencing a cell containing a string displays the string 
(previous versions displayed 0). For example, if A2 contains 
the formula A1 and Al contains "String, A2 now displays 
String. 


The vertical bar (|) is now a special character used to 
precede parse format lines, comment lines, page break 
commands, setup strings in text, and other text of a format 
nature. To use the vertical bar in text, precede it with a ", a 
blank space, or another ASCII character. 


Use the Undo feature to take back the last command or entry 
and restore the spreadsheet to its previous condition (see 
/Global, Optimum, Chapter 2). 


The file overwrite prompt is changed to Backup Change 
Overwrite. Previous versions were Change Backup Overwrite. 


The default filename will only be reset by /Load, All or 
Replace, //Import, All or Replace, and //Spreadsheets, Rename. 


At the File List, F5 reverts to the default data directory (the 
current DOS directory). 


SuperCalc uses routines provided by the program file 
SCSCREEN.drv to let you work in condensed view mode. 


Hidden Options 


If you enter the following commands as you did with prior 
releases, SuperCalc executes the commands but does not display 
options: 


/Replicate 
/eXecute 

/View 

//Export, SC3 
/Format, Define 
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= /Global,Optimum, International, Check, Memory, Boundary, 
Expanded, Video, and Attribute (available only through 
macros) 


E /Global,Row, Column, Dependent, Iteration-Control, Manual 
and Auto 


/Output, Display and Contents 
//Export and //Import of 1-2-3 files 


Compatibility Details 


As stated earlier, this release of SuperCalc can load most 
spreadsheet files created with prior releases of SuperCalc. There 
are some details, however, that we want to call to your attention. 


Special Considerations 


Existing .cal files from previous versions can be loaded into 
SuperCalc. 


Macro files created in previous versions may be affected by the 
following: 


- Additional functions for the F5 key (see Chapter 1). 
- — File deletion confirmation. 


- Changes in graphics capabilities, especially macros that 
changed the /Global, Graphics, Colors screens. 


You may continue to enter and use textual values — entries 
enclosed in quotes and parentheses (" ") — as you did in earlier 
versions. The maximum length of textual values has been 
increased from 9 to 240 characters. However, textual values over 
9 characters display as string values. Note that textual values used 
within a function now return a string value rather than a 
numerical value. 
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It is necessary to export SuperCalc files to previous versions using 
/Save,Level. In addition to the string functions, LOOKUP, 
HLOOKUP, VLOOKUP, and INDEX may now produce string 
values. 


Execute (.xqt) Files Containing a Circular Reference — 
SuperCalc3 


When current versions of SuperCalc encounter a circular 
reference, the program prompts for a CtrHBreak to stop the 
iterations. Unlike F2 in SuperCalc3, CtrHBreak will abort an .xqt 
file (called a macro file; as described in Chapter 4). 


To avoid aborting such a file, you must insert the macro 
command {ONBREAK label} in your .xqt file at any point above 
the circular reference. The label must be a name defined with the 
{LABEL} command. Then when you press CtrF-Break the .xqt file 
is not aborted. Instead, it continues execution at the line defined 
by the label. 


For example: 


Circular References — SuperCalc3 Rel. 2.0 Spreadsheets 


The order of calculation in circular references is the same as in 
SuperCalc3 Rel. 2.1, but may be different from SuperCalc3 Rel. 
2.0. As a result, some Rel. 2.0 spreadsheets with circular 
references (simultaneous equations) calculated in dependency 
order might display different values when recalculated by later 
releases. If so, to produce desired results reorganize the circular 
area of the spreadsheet to put the desired output (goal) to the 
lower-right of its circular dependencies. 
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Note that a /Global, Evaluation, Iteration-control, Fixed setting of 1, 
a /Global, Evaluation, When, Auto setting, and an order of 
calculation setting of /Global, Order, Row are equivalent to the 
default calculation settings in SuperCalc3 Rel. 1.0. 


Execute (.xqt) File Conversion — SuperCalc3 


If an .xqt file from SuperCalc3 (or earlier version) is executed by a 
later version, or read into a later version of SuperCalc, the old .xqt 
file is converted to the new format (introduced with SuperCalc4). 
Special macro commands are inserted where the function of 
certain keys in prior versions do not match the function in the 
current version. 


More frequent disk swapping may be necessary during .xqt file 
execution in a floppy disk system environment. 


A converted .xqt file can be enhanced or revised using new 
program or macro commands. For more about macros, see 
Chapter 4. 


Files Loadable by SuperCalc4 or SuperCalc3 


Note that this section refers to issues of downward compatibility 
— for those who use any release of SuperCalc3 or SuperCalc4 
and this version of SuperCalc interchangeably. 


Any release of SuperCalc3 or SuperCalc4 can load a spreadsheet 
file created with this version if you use the /Save,Level,sc3 or sc4 
to convert the file to the SuperCalc3 or SuperCalc4 format. 

Formulas not available in SuperCalc3 or SuperCalc4 become text. 


Note that in SuperCalc3, formulas and text will be truncated to 
116 characters maximum. If cells to the right of column DW are 
referred to in a formula, cell contents to the right of column DW 
are lost and formulas referencing lost cells show ERROR. 


If any functions unique to the newer SuperCalc release are used, 
earlier releases translate the formula to text. 
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Features Introduced with Prior Releases of 
SuperCalc 


Features Introduced with SuperCalc4 Version 1.10 
MH Local Area Network (LAN) support: — 


- Lock and unlock data files: Automatic file lock with 
/Load. 


- Link and unlink network drives and directories. 
- Redirect output to shared network printers or plotters. 


- Control the number of concurrent network users, based 
on number of copies or LANPAKS purchased. 


™ Configuration files retain keepable defaults (no longer kept in 
the SC4.com program file). 


NH User-defined international currency formats and date formats. 
NH New options at the Optimum Spreadsheet Conditions Menu: 


- Selectable separator punctuations for decimals, operands, 
and thousands. 


- LICS character conversion between SuperCalc4 and Lotus 
1-2-3 Release 2. 


- User-specified currency prefixes and suffixes. 
- Keepable monitor attribute (Color or Black & White). 
m Support of ASCII extended character output. 


Mm //Restrict specifies a restricted range into which data can be 
entered. 


mM Justify rearranges or realigns a specified range of text. 


m /View,Export outputs graph definitions in .pic file format. 
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m /Load,Replace and //Import, Replace clear the current file 
before loading or importing a new file. 


m //Data, Unique extracts just one of two or more identical 
records that match your specified criteria. 


NW Number and date centering. 


NW Message when using /Zap or /Quit notifies user that 
spreadsheet was changed since last save. 


Ñ Fl help available for error messages. 


= Computers and adapters that support a greater number of 
concurrently displayed graph colors are now supported. 


m To support macros or execute files created with prior versions 
of SuperCalc, these entries display the SuperCalc4 version 1.0 
menus: 


-  /Format,Define displays the prior User-Defined Format 
Menu. 


- /Global, Optimum, followed by For D, or the Up or 
Down Arrow key, displays the prior version of the 
Optimum Spreadsheet Conditions Menu within macros. 


m SuperCalc4 uses more memory than prior versions, therefore 
some very large spreadsheets may not load. Try setting 
Memory to Data-space with /Global, Optimum, Next. 


Features Introduced with SuperCalc3 Release 2.1 


Release 2.1 extended the capabilities of SuperCalc3 to support a 
wider range of computer peripherals (such as plotting devices) 
and some of the latest and most significant advances in 
microcomputer technology. 


m Additional plotters, color printers, and ink jet printers. 
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Up to 8 megabytes of expanded memory with expanded 
memory managers such as the Intel Above(tm) Board. 


IBM 3270 PC with APA card. 

IBM Enhanced Color Display monitor (ECD). 

IBM Enhanced Graphics Adapter card (EGA): Choose from up 
to 64 screen colors for viewing graphs (number of colors 
depends on monitor in use). 

More screen colors for viewing graphs on-screen with 
conventional color card and color monitor: Three 3-color 
palettes and 16 background colors. 

Dual monitor support. 


European date entry function, EDAT. 


An enhanced method of circular reference calculation 
provides faster convergence. 


Features Introduced with SuperCalc3 Release 2 


FastMath and 8087 math coprocessor support. 
Significantly greater performance speed. 
Load .cal file from any drive or directory at system prompt. 


Page Up, Page Down, Page Left, Page Right, End, Tab, 
Back Tab, Scroll Lock, Num Lock, and Caps Lock. 


Esc to Point remains On until the command or formula is 
executed. 


Highlight range while pointing with Esc. 
Period (.) or colon (:) delimiter in range entries. 


DOS directory path support. 
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Text, Center format. 


Up to 9999 rows and 122 columns, menu selectable. 
Dynamic graphic plotting device selection. 
/Global,Protect toggle to turn on/off cell protection. 
/Global,Keep to save menu selections as defaults. 
Natural (dependency) calculation order. 

Iteration count options for calculation. 

/Output, Setup extensions. 


/Zap, Yes or Contents retains default (full-screen) menu 
settings. 


Arithmetic function — RANDOM. 
Special function — ITER. 


SIDEWAYS utility for sideways printing. 


Features Introduced with SuperCalc3 Release 1 


/Arrange — secondary sort. 

Data management lists and records maintenance commands. 
Data disk drive selection. 

Double quote (") not required for text. 

Financial functions — IRR, PMT, FV, PV. 

Function name abbreviations. 


Graphing commands — up to nine graphs saved with every 
spreadsheet. 


Notes for Users of Previous SuperCalc Versions C-17 


Features Introduced with Prior Releases of SuperCalc 


m Graphs — seven types displayed or plotted without changing 


disks. 


Graph names and types listed from SuperCalc3 Directory 
Options menu. 


Special functions — TRUE, FALSE, ISNUM, ISTEXT, ISDATE. 


Insert and Delete key support. 


Features Introduced with SuperCalc2 


Arithmetic functions - ROUND & MOD. 
/Arrange — primary sort. 

Calendar functions. 

Consolidation on /Load 

Double space and Auto form feed on /Output. 
Hide values. 

Percent (%) operator. 

/Quit to another program. 

Tab on edit line. 

Textual values. 


User-defined formats. 
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Appendix D 
Notes for Lotus 1-2-3 
Users 


This appendix describes Lotus Compatibility mode, which lets you 
perform SuperCalc operations through 1-2-3’s menu structure, and 
descriptions for saving and loading 1-2-3 files. 
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Various AnswerScreens within SuperCalc list 1-2-3 command, 
function, and macro equivalents, and describe the difference 
between 1-2-3’s and SuperCalc’s cursor movement keys and 
function keys. Look for these topics on the Help Index. 


Lotus Compatibility Mode in SuperCalc 


SuperCalc offers nearly complete Lotus 1-2-3 compatibility. Not 
only do most 1-2-3 commands have equivalent SuperCalc 
commands, but SuperCalc can actually work through the 1-2-3 
menu tree. 


To enter a single 1-2-3 command sequence, select /1-2-3. /1-2-3 
has the effect of pressing / within 1-2-3; you'll see the 1-2-3 
menu. After you’ve executed the 1-2-3 command, the SuperCalc 
menus are restored. 


Or, turn on global Lotus Compatibility mode for execution of 
several 1-2-3 commands; select /Global, 1-2-3. Each subsequent 1- 
2-3 command is automatically translated into its SuperCalc 
equivalent and executed. To return to the SuperCalc menus, select 
/Worksheet, Global, sc5. 


While in global Lotus Compatibility mode, you may execute a 
SuperCalc command by selecting /sc5. You'll return to the 1-2-3 
menus after executing the SuperCalc command. 
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Lotus Compatibility Mode in SuperCalc 


The global Lotus Compatibility mode may be used to execute 
simple 1-2-3 macros directly. For more complicated macros, use 
//Macro, Convert, then execute the 1-2-3 macro. 


Although Lotus Compatibility mode is convenient, we recommend 
that you learn to use SuperCalc commands directly. SuperCalc 
offers options that you can’t access in Lotus Compatibility mode. 


Saving 1-2-3 Files 


You can save SuperCalc data directly in a Lotus 1-2-3 release 1A 
(.wks) or release 2 (.wk1) file format, using /Save with the 
appropriate 1-2-3 file extension. 


SuperCalc offers many features not available in 1-2-3, such as 
spreadsheet links, fonts, and Iteration Solve. Data or settings for 
such features may be lost when saved to a 1-2-3 format. 


To learn what happens to data or settings 1-2-3 can't handle, 
choose /Save, press F1, and review the various Related Topics 
AnswerScreens. 


Loading or Retrieving 1-2-3 Files 


Files from 1-2-3 release 1A and 2 can be loaded directly using 
/Load with the appropriate 1-2-3 filename and extension. 


Data is transferred correctly, but a few differences between 
SuperCalc and 1-2-3 may prevent an exact automatic translation of 
every detail. 


For description about date, time, and number format conversions, 


choose /Load, press F1, and review the various Related Topics 
Answerscreens. 
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The command structure of 1-2-3 has many similarities to that of 
SuperCalc. Many of the command names are the same. 


For example, 1-2-3 /Data options are found under SuperCalc’s 
//Data; /Copy and /Move are the same in both products. 


When you press F1 in Lotus Compatibility mode, you'll see the 
AnswerScreen for the SuperCalc command equivalent. For 
example, from /Worksheet, Column, Set-Width, F1 will show you 
the AnswerScreen describing SuperCalc's /Format, Column, Width 
command. 
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Appendix E 
Functional Command 
Reference 


Use the following list to identify which commands you can use to 
perform basic spreadsheet operations. The subheadings in this 
section provide an alphabetical list of the various operations 
available. Beneath the subheadings are related command 


sequences. 

Analyze Data 

//Data, Do regression analysis or analyze the 
Analysis distribution of data in a range. 
//Data,Block Fill a range with linear and geometric 


numbers, or dates and times. 


//Data, Invert and multiply matrixes; solve 

Matrix simultaneous equations. 

//Data,Table Analyze and compute 1- and 2-variable “what 
if” tables. 


Apply Fonts, Lines, Shading in Reports 


/Output, Apply fonts, lines, and shading to individual 
Attributes cells and ranges. 
/Output,Grid Apply vertical and horizontal rules around 


each cell of the output range. 


/Output, Apply horizontal and vertical separator lines. 
Lines 
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Audit a Spreadsheet 


Audit a Spreadsheet 


Alt-F1 or 
//Test 


Activate AUDIT mode, to find and replace 
data, analyze named ranges, perform tests on 
cells, and view spreadsheets from formula or 
map view. Print results through 

/Output, Options, Contents, Highlighted or 
View. 


Change Appearance or Order of Data 


/Arrange 


/Format 


/Global 


/Justify 


Copy Data 
/Copy 


//Graphics, 
Copy 


Sort contents of a block of cells, in ascending 
or descending order. Use up to three keys to 
do a multi-key sort. 


Control display formats and the appearance of 
printed output. Define numerical format, set 
column width, determine appearance of dates 
and times, justify values or text in cells. 


Establish settings for the entire spreadsheet, 
including hardware and program defaults. Set 
format and display, memory status, video and 
device attributes, and calculation frequency 
and order. 


Change text string width, justify text in blocks. 
Word-wrap continuous text. 


Copy contents of a row, column, or block, 
and transpose a block into a new location. 
Perform arithmetic operations and adjust 
formulas, accordingly. 


Copy the current chart descriptor to a new 
chart. 
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Find and Name Files 


Find and Name Files 
//File,Path Define paths for SuperCalc to search when 


//Spread- 
sheets, 
Rename 


Edit Data 
/Edit 


Erase Data 
/Blank 


/Delete 


/Zap,Yes 


//Data, 
Delete 


//Spread- 
sheets, Zap 


loading files. Search default directory, 
spreadsheet datapath, global datapath, or DOS 
SET DATAPATH= path. 


Change an open spreadsheet’s default 
filename. 


Change cell contents in the current 
spreadsheet or in another spreadsheet in 
memory. 


Erase contents of current cell, cells in a range, 
or unprotected cells. Remove Entry level 
formatting, or keep current Entry level 
formatting. 


Delete a row, column, or block of data. 
Adjacent rows or columns fill in the resulting 
gap. Adjust formulas. Delete a file from the 
default or specified drive/directory. 


Erase cell contents in the current spreadsheet, 
and reset the display formats to the default 
settings for the entire spreadsheet. 


Remove records in the current database which 
match the selection criteria. 


Clear all open spreadsheets; close all 
spreadsheets but page 1 of TEMP1. 
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Exit SuperCalc 


Exit SuperCalc 
/Quit Leave SuperCalc, and either return to the 


//Spread- 
sheets, 
Quit 


Graph Data 
//Graphics 


Hide Data 
/Format,, 


Hide 


/Format, 
Hide- 
column 


//Spread- 
sheets,Hide 


Load Data 
/Load 


operating system or directly start another 
(.com) program. Quits the current 
spreadsheet. 


Closes all open spreadsheets and exits 
SuperCalc. Select //Spreadsheets, Quit, Save to 
save all modified spreadsheets first. 


See spreadsheet data as a chart. Charts 
include Bar, Line, Dual, Area, X-Y, Radar, 
Word, Pie, Hi-Lo; create two- and three- 
dimensional charts and Exploded Pie charts. 


Make cells appear blank; values do not 
appear on-screen or print. 


Set column width to zero; cursor skips these 
columns. 


Prevent cursor from accessing spreadsheets 
and/or pages with //Spreadsheets, Goto, Next, 
Previous, and Specify. 


Load all or part of a spreadsheet from disk, 
into the current spreadsheet. Adjust 
formulas, load values only, do consolidation 
arithmetic, load named ranges. Load chart 
descriptors from other files. Load Lotus 1-2-3 
.Wk1 or .wks files. Load all pages or single 


pages. 
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//Import Load files created by other programs. File 
formats include XDIF, DIF, CSV, VisiCalc, 
dBase III, Numbers, Text. 

Macros 

//Macro Store, execute, and debug macros. 

Maintain a Database 

//Data,Input Define database range to search. 

//Data, Define selection criteria to match. 

Criterion 

//Data, Define a range to hold results. 

Output 

//Data,Find Highlight selected data. 

//Data, Place selected data in output range. 

Extract 

//Data, Eliminate duplicate data matches during 

Unique extraction. 

//Data,Select Query before extracting data. 

//Data, Remove records that match database selection 

Delete criteria. 

//Data,Parse Break continuous text strings into data fields. 

Move Data 

/Insert Insert an empty row, column, block, or page. 


Adjust formulas. Move surrounding rows, 
columns, and pages as necessary. 
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Move Data 


/Move 


Move a row, column, block, or page of data 
to a new location. Adjust formulas. Move a 
block of data, transposing rows to columns 
and vice versa. 


Name Cells or Ranges 


/Name Assign a name to a cell or range of cells; 
remove an assigned name. Extract list of 
names and associated ranges from the Named 
Range Directory into the spreadsheet. 

Networking 

//Network Share network files and devices. 

//Network, Link to (or unlink from) a file server directory. 

Directory 

//Network, Lock shared data files. 

Lock 

//Network, Unlock shared data files. 

Unlock 

//Network, Redirect output through any logical parallel 

Output port at your computer to a network printer or 
plotter. 

Print or Plot Data 

/Output Send all or part of a spreadsheet to a printer 
or file. Print multiple ranges on a single page, 
preview output on-screen. Add titles, 
headers, footers to reports; apply fonts, lines, 
and shading. 

//Graphics, Output charts to a graphics printer or plotter. 

Plot 
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Print or Plot Data 


//Network, Redirect data through any logical parallel port 

Output at your computer to a network printer or 
plotter. 

Protect/Unprotect Data 

/Protect Prevent changes to cell contents (and blank 
cells formatted at Entry level) in a specified 
range. 

/Unprotect Remove cell protection in a specified range. 

/Global, Toggle protection set with /Protect and 

Protection /Global, Unprotected on and off. 

/Global, Toggle protection of entire spreadsheet on 

Unprotected and off. 

//Network, Lock shared data files. Protect files from 

Lock alteration by other network users. 

//Network, Unlock shared data files. 

Unlock 

Restrict Data Entry 

/Global,Tab Limit cursor movement to non-blank, non- 
protected cells only. 

//Restrict Restrict data input to a specified range. 

Save Data 

/Save Save all or part of a spreadsheet in a disk file. 


Save only the calculated values, save 
protected cells or unprotected cells. Save data 
in a format compatible with SuperCalc3, 
SuperCalc4, or Lotus 1-2-3. Save all pages or 
a single page. 
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Save Data 


/Quit,Save 


/Zap,Save 


//Export 


//Spread- 
sheets, Save 


//Spread- 
sheets, Zap, 
Save 


//Spread- 
sheets, Quit, 
Save 


Save and close the current spreadsheet. 


Save the current spreadsheet and clear the 
file, but leave a blank spreadsheet on-screen. 


Save data in a file compatible with XDIF, DIF, 
CSV (Comma Separated Values), and dBase 
Hi: 

Save all modified open spreadsheets. 


Clear all open spreadsheets; save modified 
spreadsheets. 


Close all open spreadsheets and exit to the 
operating system; save modified spreadsheets. 


Save Memory 


/Global, 
Optimum, 
Next, 
Memory, 
Data-space 


/Global, 
Optimum, 
Next, 
Graphics,No 


/Global, 
Optimum, 
Minimal,No 


/Global, 
Optimum, 
Present, 
Undo,No 


Reserve memory for spreadsheet data instead 
of program files. 


Graphics files are not loaded; space is 
reserved for data files. 


Disable minimal recalculation to save 
memory. 


Disable Undo to save memory. 
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Save Memory 


//Test, Save RAM by consolidating related formulas. 

Squeeze 

Search and Replace Data 

//Test, Use AUDIT mode to find and replace data. 

Replace 

Start a New Spreadsheet 

/Zap,Yes Erase contents of current spreadsheet, and 
reset the display formats to the default 
settings. 

//Spread- Open an additional blank spreadsheet in 

sheets,New memory. 

or 

Ctrl-Return 

//Spread- Close all open spreadsheets, leaving one 

sheets,Zap blank spreadsheet. 

Troubleshooting 

//Macro, Report on transfers of control and data 

Analyze manipulation within macros. 

Alt-F1 or Activate AUDIT mode, to find and replace 

//Test data, analyze named ranges, perform tests on 


cells, and view spreadsheets from formula or 
map view. Print results through 

/Output, Options, Contents, Highlighted or 
View. 
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Troubleshooting 


Undo a Command 


/Global, Turn on the Undo function, so that 

Optimum, Ctrl Backspace takes back the last operation. 

Present, 

Undo, Yes Es 


Use Lotus 1-2-3 Commands 


/1-2-3 Execute a single command as a Lotus 1-2-3 
command sequence. 


/sc5 While in Lotus Compatibility mode, execute a 
single SuperCalc command. 


/Global, 1-2-3 Turn on Lotus Compatibility mode; execute a 
series of commands through the Lotus 1-2-3 
menu structure. 


/Worksheet, Return to SuperCalc menus from Lotus 
Global, sc5 Compatibility mode. 
//Macro, Convert Lotus 1-2-3 macros to SuperCalc 
Convert macro format. 

Use Other Programs 

/Quit,To Exit SuperCalc and go to another program 
(.com file). 

/Quit,DOS Temporarily exit SuperCalc and return to the 
operating system. To return to SuperCalc, 
enter EXIT. 

//Add-in Attach, invoke, and detach compatible add-in 


programs and functions. 
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View Data 

/Title Lock columns and rows (labels and other 
reference information) or both, on display 
window and scroll the remainder of the 
spreadsheet. 

/Window Split the display window into two parts either 
horizontally or vertically. Scroll data in both 
windows simultaneously, or independently. 

//Spread- Display up to three spreadsheets on-screen at 

sheets, once. Can use with /Window. 

Display 

//Test Use AUDIT mode to view formulas. in the 

/View, spreadsheet. 

Formula 

//Test Use AUDIT mode to view data as character 

/View,Map patterns. 
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Appendix F 
Plotter Fonts 


SuperCalc supports 16 different fonts for presentation quality 
charts. These fonts are: 


Block 
BlockBold 
Gothic 

Helv 
HelvBold 
HelvBoldItalic 
Helvitalic 
HelvLight 
HelvLightitalic 
Italic 
ItalicBold 
Roman 
RomanBold 
Script 
ScriptBold 
Stick (default) 


To see the list of fonts, display a //Graphics menu that contains 
the Font option (such as the Axis Label Definition and Options 
Menu), place the cursor in the Font field, and press Return to 
display the Select window, which lists all the fonts. You can also 
press F1 for help. 


Plotter Fonts 


F-1 


Appendix G 
Graphics Printer and 
Plotter Switch Settings 


Many of the graphics printers and plotters supported by SuperCalc 
have switches that can be set by the user. SuperCalc assumes you 
will use the settings listed here. If you use other settings you will 
have to make appropriate changes on the Global Graphics Options 
menu or the Global Spreadsheet Options menu. 


Key to terms and abbreviations: 


Term 


Number of Paper Sizes (typically 1 or 2) supported by this 
device. 


P = Parallel Port. 
S = Serial Port. 
P/S = Parallel or Serial. 


Number of pens (pen stalls) available in this pen plotter. 


SW Switch settings required for graphing with SuperCalc. For 
example: 


“SW Default” means use the switch settings specified in 
your printer or plotter manual. It might mean your device 
has no switches to set. 


“Bank S15-Sw 1 Off” means on switch bank S15, move 
switch 1 to the Off position. Other switch settings 
optional. 


“SW 6 Off” means move switch 6 to the Off position. 
Others optional. 
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General Guidelines 


General Guidelines 
If you have a choice at your plotting device, select these settings. 
For serial interface protocol: 


Select Hardwire (or Hardware) Handshake, not 
XON/XOFF or ENQ/ACK. 


For plotters: 


Select Local mode, not Remote mode. 
Select Bypass Off, not On. 
Select Standalone, not Eavesdrop. 


For printers: 


Select Auto Linefeed On, Carriage Return Off. 


If printed horizontal and vertical lines are not aligned, change from 
Bidirectional to Unidirectional printing. 


some settings are indicated with diagrams showing each switch 
setting, or with appropriate comments. 


Graphics Devices for SuperCalc 


Black & White Graphics Printers 


Anadex DP Series—PS 2, Port P/S, SW Bank S15-Sw 1 Off. 

Citizen MSP-10—PS 1, Port P SW Bank SW-1 — Sw 1, 4, 8 On; others Off. 
SW Bank SW-2 - Sw 2, 3, 5, 6, 7 On; others Off. 

Citizen MSP-15—PS 2, Port P SW same as Citizen MSP-10. 

Citizen MSP-20—PS 1, Port P SW Default. 

Citizen MSP-25—PS 2, Port P SW Default. 

C. Itoh 1550—PS 1, Port P SW Default. 

C. Itoh 8510A—PS 1, Port P SW Default. 

C. Itoh 8600—PS 1, Port P SW Default. 

Diablo P11—PS 1, Port P/S, SW S06 Off. 

Diablo P32—PS 2, Port P/S, SW S06 Off. 

Epson MX 80—PS 1, Port P SW Default. 

Epson MX 100—PS 2, Port P SW Default. 

Epson FX 80—PS 1, Port P, SW Default. 

Epson FX 85—PS 1, Port P SW Default. 
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Graphics Devices for SuperCalc 


Epson FX 100—PS 2, Port P, SW Default. 

Epson FX 185—PS 2, Port P, SW Default. 

Epson LX 80—PS 1, Port P, SW Default. 

Epson RX 80—PS 1, Port P, SW Default. 

Epson RX 100—PS 2, Port P, SW Default. 

Epson LQ 800—PS 1, Port P, SW Default. 

Epson LQ 1000—PS 2, Port P, SW Default. 

Epson LQ 1500—PS 2, Port P, SW Default. 

Facit C5500/C7500—PS 2, Port P, SW Default. 

Fujitsu DPL 24—PS 2, Port P, SW Default. 

HP LaserJet—PS 1, Port S, SW Default. 

HP LaserJet Plus—PS 1, Port S, SW Default. 

HP ThinkJet—PS 1, Port P, SW 2 & 6 Up; others Down. 
HP QuietJet Plus—PS 2, Port P, SW Default. 

IBM ProPrinter—PS 1, Port P, SW Default. 

IBM ProPrinter XL—PS 2, Port P SW 1 On. 

IBM Graphics—PS 1, Port P, SW Default. 

IBM Convertible—PS 1, Port P SW Default. 

IBM PagePrinter—PS 1, Port S, SW Default. 

IBM QuietWriter 2—PS 2, Port P, SW 3 On. 
Mannesmann Tally MT 85—PS 1, Port P, SW Default. 
Mannesmann Tally MT 86 —PS 2, Port P, SW Default. 
Mannesmann Tally MT 160—PS 1, Port P, SW Default. 
Mannesmann Tally MT 180—PS 2, Port P, SW Default. 
Mannesmann Tally MT 290—PS 2, Port P, SW Default. 
Mannesmann Tally MT 490—PS 2, Port P, SW Default. 
MPI Solution Series—PS 1 or 2, Port P/S, SW Default. 
NEC Pinwriter P2—PS 1, Port P, SW Bank “Interface Module” — Sw 5 to n/216. 
NEC Pinwriter P3—PS 2, Port P, SW Bank “Interface Module” — Sw 5 to n/216. 
NEC P560—PS 2, Port P, SW Default. 

NEC P560XL—PS 2, Port P SW Default. 

NEC P6—PS 2, Port P, SW Default. 

NEC P7—PS 2, Port P, SW Default. 

Okidata 82 A—PS 1, Port P, SW 6 Off. 

Okidata 83A—PS 2, Port P, SW 6 Off. 

Okidata 84A—PS 2, Port P SW 2 Off. 

Okidata 92—PS 1, Port P SW 6 Off. 

Okidata 93—PS 2, Port P, SW 6 Off. 

Okidata 182—PS 1, Port P, SW Default. 

Okidata 192—PS 1, Port P, SW Default. 

Okidata 193—PS 2, Port P, SW Default. 

Okidata 292 (Standard Module) —PS 1, Port P, Set Graphics UNIDR to Y. 
Okidata 293 (Standard Module) —PS 2, Port P, Set Graphics UNIDR to Y. 
Okidata 2410—PS 2, Port P, SW Bank 3 — SW 4 Off. 
Ricoh LP4080R—PS 1, Port P, SW Default. 

Siemens PC88—PS 1, Port P SW Default. 

Siemens PC89—PS 2, Port P, SW Default. 

Xerox 4045—PS 1, Port P, SW Default. 
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Graphics Devices for SuperCalc 
TI Omni 850—PS 1, Port P SW 
ER TIA Be ES 
TI Omni 855—PS 1, Port P SW 
LEADER 
ON 
OFF 
Toshiba P351—PS 2, Port P, SW 3 (Bit 2, 3 On). 
Toshiba 1350—PS 2, Port P SW Default. 


Color Graphics Printers 


(Program supports process color ribbon.) 


Anadex DP-9725—PS 2, Port P/S, SW Bank S15 - Sw 1 Off. 

C. Itoh 24 LQ—PS 2, Port P SW Default. 

C. Itoh 1550 SCEP & NLQ—PS 2, Port P/S, SW Default. 

C. Itoh 8510 SCEP & NLQ—PS 1, Port P/S, SW Default. 

Diablo C150—PS 1, Port P SW Default. A 
Epson EX800—PS 1, Port P SW Default. 

Epson JX 80—PS 1, Port P SW Bank 2 - Sw 4 Off. 

Epson LQ2500—PS 2, Port P, SW Default. 

Facit C5500—PS 2, Port P SW Default. 

Facit C7500—PS 2, Port P SW Default. 

Fujitsu DPL 24C—PS 2, Port P, SW Default. 

Genicom 3000 Series—PS 2, Port P/S, SW Default. 

IBM 5182 Color—PS 2, Port P, SW Default. 

IBM 3852 Color Jetprinter—PS 1, Port P, SW Default. 

IDS Prism 80—PS 1, Port P/S, SW Bank S4 — Sw 5 Off; Sw 7 On. 
IDS Prism 132—PS 2, Port P/S, SW Bank S4 — Sw 5 Off; Sw7 On. 
NEC Pinwriter P2C—PS 1, Port P SW Default. 

NEC Pinwriter P3C—PS 2, Port P SW Default. 

NEC P560—PS 2, Port P, SW Default. 

Okidata 292—PS 1, Port P, Set Graphics Unidr to Y. 

Okidata 293—PS 2, Port P, Set Graphics Unidr to Y. 
Quadjet—PS 1, Port P, SW Default. 

Tektronix 4696—PS 1, Port P SW Default. 

Toshiba P351C—PS 1, Port P, SW 3 (Bit 2, 3 On). 
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Graphics Devices for SuperCalc 


Pen Plotters 


Amdek Amplott—PS 2, Pens 6, Port P, SW 


BAUD RATE DATA FORMAT INTERFACE SELECTION 
| 
To AE n > A leo: OL + Y 


Apple 410—PS 2, Pens 4, Port S, SW 


ALS 


Calcomp M84—PS 1, Pens 8, Port S, SW 


BAUD RATE PAR EVEN 7BIT 1STOP ADDR DTR RS232 


LA 


C. Itoh CX-6000—PS 1, Pens 6, Port P, SW Default. 

Enter Sweet-P 100—PS 1, Pens 1, Port P SW Default. 

Enter Sweet-P 600—PS 2, Pens 6, Port P, SW Default. 

Epson HI-80—PS 1, Pens 4, Port P, SW Default. 

Facit 4550—PS 1, Pens 6, Port P/S, SW Bank 1-SW 1, 4, 6, On. 

Facit 4551—PS 2, Pens 6, Port P/S, SW Bank 1-SW 1, 4, 6, On. 

Gould 6120—PS 2, Pens 7, Port S, SW Bank A-SW 1, 5, 6, 8, On; 
SW Bank B-SW 1, 2, 3, 4 On. 

Gould 6310—PS 1, Pens 7, Port S, SW Bank 2-SW 1, 3, 4,5, 6 On. 

Gould 6320—PS 2, Pens 10, Port S, SW Bank 2-SW 1, 3, 4, 5,6 On. 

Graphtec MP 2000—PS 2, Pens 8, Port S, SW 1, 4, 9 On. 

HP ColorPro'—PS 1, Pens 8, Port S, SW 2, 3, 6, 7 On. 

HP 7470A'—PS 1, Pens 2, Port S, SW. 


TEST US 


$2.51 Y US B4 Bs. Be -Bı 


al 


D MET 


¡SuperCalc requires the HP 17255D cable for HP plotters (not the 172554). 
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Graphics Devices for SuperCalc 


HP 7475A'—PS 2, Pens 6, Port S, SW (See diagrams for each paper size below): 
Small paper (81/2 x 11”) Large paper (11 x 17”) 


t Y US A3 B4 B3 B a Y US CAS: B4 BI B2 


A E 


HP 7550A—PS 2, Pens 8, Port S, SW Default. Requires cable HP 17255F. 
HP 7580—PS2, Pens 8, Port S, SW, Parity Off, Full Duplex, 4800 Baud. 
HP 7585—PS2, Pens 8, Port S, SW, Parity Off, Full Duplex, 4800 Baud. 
Hiplot DMP-29—PS 2, Pens 8, Port S, SW 
+ 2-3 404. 4. 3 

| 
I I i I I I I 1 0 


BAUD RATE PAR ODD SW6 MT/EG SW7 


IBM XY/749—PS 1, Pens 8, Port S, SW 


BAUD RATE PAR EVEN 7BIT 1STOP ADDR DTR RS232 TEST US 
T Z ee SB F7 G 9 1G Daz 


IBM 7371—PS 1, Pens 2, Port S, SW US, B4, B1 to position 1; others to position 0. 
IBM 7372—PS 2, Pens 2, Port S, SW (See paper sizes below): 
8!/2 x 11” paper: SW US, B4, B1 to position 1; others to position 0. 
11 x 17” paper: SW US, A3, B4, B1 to position 1; others to position 0. 
Nicolet Zeta 8—PS 2, Pens 8, Port S, SW Bank SW1 — All switches Off. 
SW Bank SW2 & SW3, see diagrams below. 
SW Bank SW4A - Sw 7 Off. 
SW Bank SW4B - Sw 9 Off. 


SWITCH SW2 SWITCH SW3 


000000 MUDÓ 


Roland DG DXY-800—PS 2, Pens 8, Port P SW Default. 
Roland DG DXY-880—PS 2, Pens 8, Port P/S, SW Default. 


¡SuperCalc requires the HP 17255D cable for HP plotters (not the 17255A). 
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Sanyo PR100—PS 2, Pens 4, Port S, SW 


AMLO 


Strobe 100—PS 1, Pens 1, Port S, SW Parity Switch, mid position, No Parity. 
SW Rotary Baud Rate, Position C, 4800 Baud. 
Strobe 260—PS 1, Pens 8, Port S, SW (same as Strobe 100). 
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Appendix H 
Using SIDEWAYS 


Introduction 


What if your spreadsheet is too wide for your printer? 


Now you can print all of the columns of your spreadsheet, at one 
time, on one continuous page. The SIDEWAYS program rotates 
your spreadsheet by 90 degrees as it prints, so columns that 
stretch beyond the right edge of the standard sheet of paper do 
not get chopped off. SIDEWAYS prints right across the 
perforations of your printer paper. 


Reminder 


The SIDEWAYS program file, SIDEWAYS.com, 
and the printer installation file, SWSETUP.com, 
are shipped on the SuperCalc Utility diskette. 


Guidelines for Using SIDEWAYS 


This version of SIDEWAYS works only with print files created by 
SuperCalc. To print a spreadsheet with SIDEWAYS, you must 
create a report file, which the SIDEWAYS program can read. This 
file is a special SuperCalc text file. A .prn extension is appended 
to the filename automatically when you use /Output,File, unless 
you enter a different extension. 


Using Sideways 


H-1 


Guidelines for Using Sideways 


There are three basic steps to printing with SIDEWAYS: 


1. Install (and if necessary, configure) your printer for 
SIDEWAYS. This is a one-time step and does not have to be 
repeated each time you use SIDEWAYS. You use the 
SIDEWAYS utility program SWSETUP. aod 


2. Start SuperCalc and load the spreadsheet you want to print. 
Use /Output, File to create a .prn file containing the data you 
want to print. 


3. Leave SuperCalc and load SIDEWAYS. On the SIDEWAYS 
menu, adjust the printing options, type the name of the file 
you want to print, and press Return. 


The instructions for these basic steps are covered in the following 
sections. 


Installing Your SIDEWAYS Printer 
Before using SIDEWAYS, you must tell the program which printer 


you are using. This is a one-time program setup procedure. You 

will not need to configure SIDEWAYS again unless you change 

printers. 

1. Copy SIDEWAYS and SWSETUP to drive C, if you’re using a 
hard disk. Type SWSETUP at the C prompt and press 
Return. If the files are in a floppy-diskette drive, then log 
onto that drive before typing SWSETUP. 

2. The SWSETUP program displays a list of supported printers. 
See Supported Printers at the end of this appendix for a 
sample list display. 

3. Type the number corresponding to your printer, then press 
Return. 

In most cases that’s all there is to it. In some instances SWSETUP — 


asks you to make a selection from a list of models. SWSETUP 
modifies your copy of the SIDEWAYS program to operate with 
the printer you select. 
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Changing Option Settings 


You can use SIDEWAYS as is, with standard type size, margins, 
and spacing already set for you. But if you want to change any 
options at the SIDEWAYS menu, the program provides: 


m A choice of nine type sizes. 
Complete control over margins. 
Variable spacing between characters and lines. 


A double-strike option for added print density (type weight). 


Support of DOS directory pathing. 
At the system prompt, do one of the following: 


1. With SIDEWAYS in the current drive, type SIDEWAYS then 
press Return. 


Or 


2. With SIDEWAYS in another drive, such as drive B, type: 
x:SIDEWAYS and press Return (where x is the drive letter). 
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You see a copyright notice. Press Return, and you see the 
SIDEWAYS menu. 


SIDEWAYS version 3,18 


Printer port: LPT1: IBM Graphics Printer 


Vertical form size (inches): 11,48 
Horizontal form size (inches): 8.88 


Character font: Normal 5 x 15 dot matrix 

Density: Single 

Character spacing (dots): 1 12,88 characters per inch 
Line spacing (dots): 6.66 lines per inch 


Left margin (inches): 

Top margin (inches): 

Bottom margin (inches): 53 lines per page 
Starting page: 

Directory: C:NDRAFT4 

Enter name of print file: 


F1 for HELP F18 to exit 


The options on the SIDEWAYS menu are preset for a typical 
printout on continuous-form or single-sheet 8-1/2 by 11 inch 


paper. 


The SIDEWAYS menu provides ten appearance options that let 
you control certain aspects of your printout, and a Starting page 
option. 


NW Four appearance options are toggle fields. Press any key, 
such as the Spacebar, to display each setting available. The 
toggle fields are: 


Printer port — LPT1:, LPT2:, LPT3:, or COM1:, COM2:. 
Horizontal form size (inches). 


Character font — 9 type sizes: Miniscule through 
Mammoth. 


Density — Single, Double, or Half (available on some 
printers). 
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m The other six appearance options are changed by typing over 
the current settings. 


If your entry is invalid, SIDEWAYS beeps or displays an error 
message. The field reverts to its previous value. 


m The Starting page option lets you skip to any page in your 
print file to start the printing. 


Printer Port 


LPT1:, LPT2:, and LPT3: are for parallel printers; COM1: and 
COM2: are for serial printers. The default is always LPTT1.. 


Paper Dimensions 


These settings are especially important when you are printing 
spreadsheets with many rows of data (see the section Long 
Spreadsheets later in this appendix for guidelines). 


Vertical form size is the distance between perforations of your 
printer paper. Whenever SIDEWAYS finishes printing a page, it 
form feeds to the next multiple of vertical form size. This setting 
is normally set to 11 inches, but you can set it to some multiple of 
actual form size, such as 22 or 33 inches. 


Horizontal form size refers to your paper width. If you have a 
wide-carriage printer, you can toggle the setting between 8 inches 
and approximately 13.6 inches, depending on your printer; if you 
have a narrow-carriage printer, leave it set to 8 inches. 


Type (Font) Weight and Size 


Character font is a toggle field that offers a choice of nine type 
sizes: Miniscule, Very Tiny, Tiny, Small, Normal, Large, Extra 
Large, Huge, and Mammoth. The right of the screen shows the 
dimensions of the dot matrix — the vertical and horizontal print 
dots that make up each character in the selected font. 
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Density is the type weight (half-strike, single-strike, or double- 
strike). 


Character and Line Spacing 


You can set different character and line spacing for each character 
font. When you change fonts, SIDEWAYS shifts to the standard 
character and line spacing associated with the new font. 


Character spacing is the distance between successive characters, 
measured in terms of the vertical dot density of the printer. 
Decreasing this number crowds characters together; increasing it 
spreads them apart. The number of characters per inch appears 
at the right. 


Line spacing is the distance between successive print lines, 
measured in terms of the horizontal dot density of the printer. 
Decreasing this value crowds lines together; increasing it spreads 
them apart. The number of lines per inch appears at the right. 


Margins 


Left margin controls the amount of blank space in inches between 
the left edge of the printed report and the leftmost SIDEWAYS 
print column. 


Top margin controls the amount of blank space in inches 
between the upper edge of the paper and the first SIDEWAYS 
printed line. 


Bottom margin controls the amount of blank space in inches 
between the lower edge of the paper and the last SIDEWAYS 
printed line. 


Starting Page 


Starting page lets you skip over the initial pages of a print file; it 
is normally set to 1 (recommended). The page size is determined 
by margins, spacing, and font settings. If you change the Starting 
page setting, you may need to change other settings accordingly. 
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Saving Option Settings 


Once you have chosen the SIDEWAYS appearance options, you 
can save them to disk as program defaults by pressing F9. Each 
time you start SIDEWAYS, the values that you saved appear. 


The default option values are saved in a file called SIDEWAYS.dft 
on the default drive. Whenever you run SIDEWAYS, the program 
reads in SIDEWAYS.dft and sets up the option values 
accordingly. 


If there is no SIDEWAYS.dft, the program uses its own internal 
set of default options. 


In addition to the default options file, you can create as many 
named options fields as you need — each with a different set of 
defaults. To create a named options file, press F3. Specify a 
name when prompted — BUDGET, for example. When you 
press Return, the current option settings will be saved under that 
name with extension .sno. 


To load and use these options, start SIDEWAYS and press F4. 
Enter the option file name when prompted. The SIDEWAYS 
menu will display those settings. You may change settings before 
you print, if necessary. 


Exiting from SIDEWAYS 


Press F10 to exit SIDEWAYS. The original drive and directory are 
restored at the system prompt. 


Printing Spreadsheets with SIDEWAYS 


To print a spreadsheet sideways on your printer, you must first set 
up the SIDEWAYS program, specifying the printer and adjusting 
settings as needed. The instructions for this setup are in the 
previous sections of this appendix. 


Using SIDEWAYS H-7 


Exiting from SIDEWAYS 


The remaining steps for printing are: 
1. In SuperCalc, output the desired data to a .prn file. 


2. In SIDEWAYS, adjust the settings and print the .prn file. 


Outputting Data to a .prn File 


These are the steps for creating the .prn file containing the data 
you want to print using SIDEWAYS: 


1. Start SuperCalc and load the spreadsheet containing the data 
you want to print. 


2. Select /Output,File,(filename), then press Return. 
If you enter the name of an existing file, SuperCalc prompts 
you to overwrite the original file, with or without making a 
backup copy, or you can select a different name. 

3. Select Range. 

4. Enter the range of data to include in this file. Point or enter 
the beginning and ending cell addresses. The range must be a 


single block. 


5. Select Options. You must have the following settings to print 
your spreadsheet properly using SIDEWAYS: 


m Report Format must be set to Formatted, No. 
= keport Format must be set to Spool, No. 


m Page width must be less than 240 but wide enough to 
include your spreadsheet contents. 


6. Select Quit to exit the Output Options Menu. 
7. Select Go to create the prn file. 


Your .prn file is created with the name you specified in step 2. 
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Printing the .prn File 


Once you have created the .prn file, these are the steps for 
printing this file using SIDEWAYS: 


1. Exit SuperCalc and start SIDEWAYS with a single command. 
Select /Quit,To,SIDEWAYS and press Return. The title 
screen appears. 


2. Press any key, and you see the SIDEWAYS menu. 


On this menu, you can indicate printer settings according to 
your current needs, as described in Changing Option Settings, 
earlier in this appendix. 


3. When the settings are correct, move the cursor to the line 
“Enter name of print file:” Notice that the line directly above 
this line, “Directory,” shows the current directory. 


4. Enter the filename from step 2 in the preceding section, 
Outputting Data to a .prn File, and press Return. You can 
also press the Right Arrow to sequentially display all files 
with a .prn extension. 


The file is sent to the printer through SIDEWAYS. 


Long Spreadsheets 


If a spreadsheet contains more rows than can fit on the page (that 
is, between the two tractor feed edges of the paper), the rows that 
don’t fit are printed on successive pages, starting at the top of 
each page. To fit more rows on the page, you can try decreasing 
the Line spacing setting or changing the Character font setting to 
a smaller type size. 


The Form size settings on the SIDEWAYS screen and the Length 
and Width settings on SuperCalc’s Output Options Menu affect 
how your spreadsheet prints. 


The Lines per page indicator on the SIDEWAYS menu is calculated 
from all settings on the screen; to increase or decrease the 
number, try adjusting the Line spacing or the Character font 
setting, and watch the Lines per page number increase/decrease. 


Using SIDEWAYS H-9 


Exiting from SIDEWAYS 


Stopping the Printer 
To abort printing when you are using SIDEWAYS, press P. 


The printer stops at the current line, or when the buffer is empty, 
and does a form feed. Printing will not resume where the process 
was aborted. Here is a spreadsheet printed with SIDEWAYS: 
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Help 


Press F1 to see this list of key function definitions and additional 
information (note that each option on the SIDEWAYS menu is 
called a field): 


Arrows (Up Move from field to field. 

or Down) 

F2 or Esc Cancels entry and returns to former contents. 
Backspace Deletes the last character typed. 

Return Completes an entry. 

F3 Saves settings to a named options file. 

F4 Loads a named options file. 
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F9 Saves current options. 
F10 Exits. 
Selecting Files 


With the cursor at the Enter name of print file field, you can 
review the .prn filenames in any drive or directory. 


The current drive and directory are displayed at the Directory 
field. To review the .prn filenames in the current drive and 
directory, press Right Arrow. Then, when you have reached the 
file you want to print, press Return to print it. 


When you reach the end of the .prn filename list, SIDEWAYS 
beeps and displays the message File not found. 


To review all filenames in the current directory, not just .prn 
filenames: 


m= For all filenames, enter *.* and press Right Arrow for each. 


m Fora set of filenames, use the DOS wildcard characters * or ? 
to define the set, then press Return. For example, typing 
REPORT??.FEB displays all files named REPORT followed by 
2 characters with extension .feb. 


m For filenames in a drive other than the current one, enter the 
drive before the filename. For example, A:*.* or C:*.PRN. 


Drive Names 


The drive you specify at the Enter name of print 
file field overrides the current drive at the 
Directory field. 


If the file you want to print is located in a subdirectory, enter the 
subdirectory in the Directory field. Subdirectories are typically 
used to divide the large number of files that can be stored on a 
hard disk into smaller, more manageable sets. You'll find 
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Help 


information about making and changing directories in your DOS 


manual. 


Supported Printers 


You can configure SIDEWAYS for the printers listed on the 
SWSETUP printer selection screen or subscreens. 


SIDEWAYS Printer Selection 


Your current Printer selection is: 
IBM Graphics Printer 


Which of these printers do you use? 


IBM Printer 
Anadex 9898 Series Printer 
C. Itoh Printer 
Citizen MSP-18-MSP-15+P2B/P25 
Dataproducts P-88/132 
Diablo Printer 
Epson Printer 
Epson-compatible Printer 
Fujitsu DPL-24 1/C Printer 
18, Star Gemini 18X/15xX 
11. Genicom 3000 Printer 
12, Hewlett Packard Printer 


Enter a number between 1 and 22, or B to 


IDS Prism, 468, or 568 

Okidata Printer 

Mannesmann Tally Printer 

MPI Sprinter 

NEC Printer 

Printek 918, 928, 938 

Printronix MUP 158B 

Quadram Quad jet Printer 

Texas Instruments Printer 

Toshiba Printer > 


cancel ,,, 


If your printer is not listed on the printer selection screen, check 
your printer manual for a reference to compatible printers. Your 
printer might be compatible with one of the dot-matrix printers 
listed by SWSETUP. For example, several printers — with various 
brand names and model numbers — are compatible with Epson 
(look-alike) printers or the C.Itoh Prowriter. 
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Advanced Applications 


The SuperCalc Demonstration Files 


There are several sample files included with SuperCalc, to 
illustrate applications for SuperCalc’s many features. These files 
demonstrate financial and scientific uses, show you how charts 
can visually present your data, and illustrate how macros can 
automate various database operations. 


We recommend that you review these files and examine their 
design. You may use them as is, or modify them to suit your 
needs. In addition, the formulas in these files provide real-life 
examples that may help you in designing your own spreadsheets. 


The file DEMOS.cal describes most of these demonstration files. 
Also, check the README.prn file (on one of the SuperCalc 
diskettes) for additional files made available after this manual 
went to print. 


Financial Demonstration Files 


TABLE Create a table of values and results from your 
spreadsheet. Enter input values in the table, 
press F9 and the results of your spreadsheet 
calculation are added to the table. 


CURRENCY Calculate a yearly balance sheet from desired 
quarterly net incomes. Perform “what-if” 
projections based upon anticipated business. 
You can even change the currency. 
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LOAN Calculate monthly payments and interest on a 
loan, given the loan value, interest rate and 
term. You can also print a copy of the loan 
table, or save the loan table to a separate file. 


COMM Track various commodities over time, charting es 
their market fluctuations. 


Scientific Demonstration Files 


With each of these files, the iterate feature is used so you only 
need to enter the function in one cell of the spreadsheet. 


FNPLOT Quickly chart a function. Enter the function, 
enter the range, then press F9 to calculate and 
F10 to view the chart on-screen. 


FNMAX Solve for the maximum(s) of a function. 
Enter the function and initial guess near a 
maximum. SuperCalc iterates around the 
maximum until it is found. 


SIMPSON Use simpson integration to integrate a 
function. Enter your function, set the 
integration limits and the number of steps to 
use, press F9 and numerically integrate your 
function between the limits. 


Statistics Demonstration File 


GROWTH Performs a logarithmic projection. Charts 
display the forecast either as a direct 
projection or within the 95% confidence level. 
Does not account for seasonal variations. 


Chart Demonstration File 


CHARTS Contains sample charts constructed from 
spreadsheet data. 
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Games Demonstration File 


BLACKJCK Play blackjack from this spreadsheet. It 
contains several useful techniques that may 
apply to other spreadsheets. 


Database Demonstration Files 


WINE A database of wines in a wine cellar, 
automated by macros. 


DATA Illustrates basic database setup and use. 

DATA-ADV Illustrates some of SuperCalc’s advanced 
//Data options, such as Parse, Table, and 
Matrix. 


Data Entry Demonstration File 


RUN Enter daily run distances and times, and view 
charts showing distances and time progress 
for the month. 


Other Files 


An additional file, MACROS.cal, offers practical macros you can 
use while building and working with your spreadsheets. We 
recommend that you load this file into memory along with your 
own spreadsheets, so these macros can be used whenever you 
need them. 


When you load MACROS.cal, an introductory screen describes 
the file and lists the macros available. 
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Appendix K 
Using CGI Drivers 


Introduction 


This appendix explains how to use the external CGI (Common 
Graphics Interface) drivers from Graphic Software Systems (GSS). 
GSS has developed a standard external CGI driver interface that 
many manufacturers support when they release a new device. 
This means that you have access to these devices from SuperCalc 
through the external CGI device driver before support is generally 
available from other products. 


SuperCalc supports several GSS external devices directly through 
device selection menus. These devices have been tested with the 
product and set up for you, so much of the guesswork has been 
eliminated. However, you still need to install these devices. 


SuperCalc also provides a generic “hook” that gives you the 
capability of installing other CGI drivers and accessing them 
through a “generic” option on the device selection menu. See the 
order form enclosed in your SuperCalc package for a list of 
available drivers with price information. Neither menu-selected 
nor generic CGI drivers support OS/2 Real Mode. CGI drivers 
support only slant patterns in chart pattern fill. 


The CGI driver interface also supports an earlier driver standard 
called VDI (Virtual Device Interface). Except as noted in this 
appendix, VDI drivers may also be used via the generic CGI 
interface. 


Having generic access to drivers in this manner gives you great 
flexibility, but it also puts the responsibility of setup and testing 
on your shoulders. Since these drivers are external to SuperCalc, 
there is no way for SuperCalc to offer the normal measure of 
device checking and setup provided for fully supported devices. 
You may need to consult the driver manufacturer’s recommended 
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procedure for installation and setup before sending output 
through SuperCalc to one of these devices. 


Following are instructions for installing any external CGI device 
driver, whether provided with SuperCalc or not, as a normal DOS 
driver, much as you would install a RAM disk driver. There is 
one driver called GSSCGL.sys which controls several “logical” 
devices. These logical devices are: PRINTER, PLOTTER, SLIDE, 
METAFIL, DISPLAY, and CAMERA. There are many drivers which 
can be associated with any of these logical devices. For example, 
the PostScript driver is called PSCRIPT.sys and is associated with 
the PRINTER logical device. 


Each external CGI device has several optional settings. If you 
want to use the default settings, you don’t have to do anything 
other than install the device. If you want to change a default 
setting, use the DOS command SET to add a setting to the 
environment. The most common setting is to associate a logical 
device with an external driver. For example: 


SET PRINTER=THERMAL 


will associate your logical device PRINTER with a CGI driver 
called THERMAL sys. 


Installing GSS External CGI Device Drivers 


To install a GSS/CGI driver, perform the following steps. You 
may skip steps 1 and 2 if you have already copied all SuperCalc 
disks to your CALC directory, as outlined in Chapter 1 of the 
User’s Guide. 


1. Copy GSSCGL.sys into the directory where you would like to 
keep your external drivers. For this example let’s assume that 
the directory is C:\CALC. 


COPY A:GSSCGL.SYS C:\ CALC 
2. Copy any other drivers that you want into that directory. (See 
the section Supported CGI Devices, later in this appendix, for a 


complete list of all the drivers provided with SuperCalc.) For 
this example let’s assume that you want PostScript, CGM 
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(Common Graphics Metafile), and the Computer Associates 
Graphics Service drivers. 

COPY A:PSCRIPT.SYS C:\CALC 

COPY A:META.SYS C:\CALC 

COPY A:CAGS.SYS C:\CALC 


3. For each optional driver add a line to the bottom of your 
CONFIG.sys file of the following form: 


DEVICE=C:\CALC\ filename /GROUP:OUTPUT 


4. Add the following as the last line of CONFIG.sys: 
DEVICE=C:\CALC\GSSCGLSYS 


For our example CONFIG.sys would look like this: 
DEVICE=C:\CALC\PSCRIPT.SYS /GROUP:OUTPUT 
DEVICE=C:\CALC\META.SYS /GROUP:OUTPUT 
DEVICE=C:\CALC\CAGS.SYS /GROUP:OUTPUT 
DEVICE=C:\CALC\GSSCGLSYS 


5. Reboot your computer. 


6. If you receive the “Out of environment space” message 
during reboot, use the DOS SHELL command to increase your 
environment space. 


Installing With the Transient Option 


The external CGI drivers from GSS can take up a fair amount of 
memory from DOS even when they are not in use. This is 
undesirable and can be avoided by installing the GSSCGI.sys 
driver with the /T option (which stands for transient). 


1. Change the last line in your CONFIG.sys file to read 
DEVICE=C:\CALC\GSSCGLSYS /T 
2. Copy the file DRIVERS.exe from one of your SuperCalc 


diskettes into your SuperCalc directory. The README.prn 
file tells which diskette has this file. 
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If you want to use VDI drivers or other software products that 
don’t support the transient option, remove the /T from the last 
line in your CONFIG.sys file. 


Loading the Transient Drivers 


You must execute the program DRIVERS before starting 
SuperCalc. This will load the required drivers into memory and 
make them available to SuperCalc. When you are finished with 
SuperCalc, you can free up this memory by executing the 
program DRIVERS with the /R option (which stands for remove). 


For example: 


DRIVERS 
SC5 
DRIVERS/R 


Generic External Devices 


SuperCalc provides the setup for some of the most popular 
external device drivers through the device selection menus. For 
drivers included on SuperCalc diskettes, you can select an output 
port with /Global,Graphics, Options. For other (generic) drivers, 
the port is set by the manufacturer. See the documentation that 
came with your driver. You will also find selections for generic 
external devices. Before you can access these devices, you must 
set them up at the DOS level. For example, serial device drivers 
may require using the DOS MODE command to set the operations 
mode, including baud rate and parity. 


Let’s assume that you bought a new thermal wax color printer and 
the manufacturer supplied a driver called THERMAL sys. 

Assume that you have installed the printer and have run the 
manufacturer’s test programs to make sure it works. If you want 
to access it through SuperCalc: 


1. Add this line to CONFIG.sys before the GSSCGI.SYS line and 
reboot: 


DEVICE=C:\CALC\THERMAL.SYS /GROUP:OUTPUT 
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2. Type this line at the DOS level: 
SET PRINTER=THERMAL 


3. Many generic drivers let you set the port through a DOS 
command. If THERMAL.sys is such a driver, you could use 
this command to direct output to LPT2: 


SET THERMAL=LPT2 


4. Run DRIVERS (if transient — see above) and then start 
SuperCalc by entering SC5. i 


5. Select the External CGI printer as your output device by 
entering the following SuperCalc command: 


//Graphics,Global,Drivers,CGI,Printer,External CGI Printer 


You are now ready to access your new printer. 


Overriding Driver Settings 


Each CGI driver supported on the menu may have several 
suggested default settings. You may override any setting from the 
DOS prompt level. SuperCalc will first look for your settings 
before adding its settings. This will allow you to selectively 
override any defaults. 


For example, the Matrix PCR 2K resolution film recorder has the 
following options set: 


MTXS_XDIM=7500 
MTXS_YDIM=7500 


Let’s assume that you wanted the dimensions to be 7000x7000. 
You would enter the following commands at the DOS prompt 
before running SuperCalc, or include them in AUTOEXEC.bat: 


SET MTXS_XDIM=7000 
SET MTXS_YDIM=7000 


SuperCalc would see these settings and not change them. 
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Overriding Driver Settings 


For DOS environmental commands associated with the CGI driver 
you are using, see the following sections or the GSS/CGI 
documentation provided by the manufacturer. 


Supported CGI Devices 


To access an external CGI driver, use the following SuperCalc 
command: 


//Graphics,Global,Drivers,CGI, class,device 
The possible choices for class and device are listed in the table 


below. The table also lists the driver file that is required for each 
device and the section of this manual that describes how to use 


each supported driver. 


Class Device Required Driver Description 
DISPLAY External CGI Display — Generic 
PRINTER AST Turbo Laser LL.sys LaserGraphics 
Language 
Apple PostScript PSCRIPT.sys PostScript 
PostScript Printer PSCRIPT.sys PostScript 
QMS Laser printer QMS.sys OMS Printer 
External CGI Printer — Generic 
PLOTTER External CGI Plotter — Generic 
CAMERA LaserGraphics 
Language LL.sys LaserGraphics 
Language 
Polaroid Palette PALETTE.sys Polaroid Palette 
PCR 2K resolution MTXSCODL.sys Matrix QVP 
PCR 4K resolution MTXSCODL.sys Matrix QVP 
SCODL Camera MTXSCODL.sys Matrix AVP 
External CGI Camera — Generic 
METAFIL CGM File META.sys CGM 
Video Show VIDEOSHO.sys VideoShow 
Presentation 
Graphics 
LaserGraphics 
Language LL.sys LaserGraphics 
i Language 
PostScript File PSCRIPT.sys PostScript 
SuperImage 1.5 File SUPERIMG.sys SuperImage 
Ventura VENTURA.sys Ventura file 
output (GEM) 
External CGI Metafile — Generic 
SLIDE CA Graphics Service CAGS.sys CA Graphics 
Service 
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LaserGraphics Language Converter 
Filename: LL.sys 


Use the following SuperCalc commands to access this driver: 


//Graphics,Global,Drivers,CGI,Printer,AST Turbo Laser 


//Graphics,Global,Drivers,CGI,Camera,LaserGraphics Language 
//Graphics,Global,Drivers,CGI,Metafile, LaserGraphics Language 


Environmental Settings: 


You can specify the following settings: 


Command Function 

SET LLOPT=(options) Sets options for printers, fonts, 
eto. 

SET LLOPT 


Specifies the following options. Separate each option with 
commas, and abbreviate options to 3 or more characters if 
desired. Default settings for these options are listed after the 
explanations. 


CPRN, Output device type: color printer, black and 
BWPRN, or white printer, film recorder. 

FR 

N:n Number of copies (n) of each image to print. 
R:n Resolution (n). Use with devices that are 


capable of multiple resolutions. Values are: 
O=device-dependent, 1=low, 2=high. 


Using CGI Drivers 


K-—/ 


Supported CGI Devices 


CVS, BVS, 
WVS, NVS 


LIN:n 


INVERT 


Vector saturation. Relevant only to minimum 
width lines (width of one device unit). 
Prevents halftone lines that are too light or 
invisible. The LL driver saturates minimum 
width lines as follows: 


= CVS (color vector saturation) — 
Converts to closest primary color: 
black, white, red, green, blue, yellow, 
cyan, magenta. 


a BVS (black vector saturation) — 
Converts to black unless line is white. 


ES WVS (white vector saturation) — 
Converts to white unless line is black. 


Ed NVS (no vector saturation) — Performs 
no conversion. 


Thin or thick lines. Use to specify that all 
lines whose width is less than or equal to n 
will have minimum width, and all lines whose 
width is greater than n will be thick (drawn 
like polygons). 


Switch black and white. Use when images 
are white on black but should print as black 
on white. 


Default Values of LL Options: 


INVERT 


Film recorder output device 


No vector saturation 
(If output device is CPRN, then default is CVS; 
if BWPRN, then BVS) 


One copy 
Device-dependent resolution 


Minimum width lines 
Off 
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PostScript 


Filename: PSCRIPT.sys 


Use the following SuperCalc commands to access this driver: 
//Graphics,Global,Drivers,CGI,Printer,Apple PostScript 
//Graphics,Global,Drivers,CGI,Printer,PostScript Printer 
//Graphics,Global,Drivers,CGI,Metafile,PostScript File 


Hardware Fonts: 


The following table shows the font mapping for PostScript 
devices. The first column lists the SuperCalc font and the second 
and third columns list the fonts that will appear on the screen and 
printer, respectively, when a PostScript device is selected. Note 
that the fonts that appear on the screen will be placed in the same 
positions as in PostScript output, even though the appearance of 
individual characters will be slightly different. 


SuperCalc Screen PostScript 

Stick Helv Helvetica 

Block Helv Helvetica 
BlockBold HelvBold HelveticaBold 
Roman Roman TimesRoman 
RomanBold RomanBold TimesBold 

Italic Italic Timesltalic 
ItalicBold ItalicBold TimesBoldItalic 
Script HelvItalic HelveticaOblique 
ScriptBold HelvBoldiItalic HelvBoldOblique 
Gothic RomanBold TimesBold 
HelvLight Helv Helvetica 
HelvLightltalic HelvItalic HelveticaOblique 
Helv Helv Helvetica 
HelvItalic HelvItalic HelveticaOblique 
HelvBold HelvBold HelveticaBold 
HelvBoldItalic HelvBoldItalic HelveticaBoldOblique 
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Default Settings: 

Resolution 1215 x 1590 

Aspect ratio 1:1 

Horizontal 150 r 
dpi 

Vertical dpi 150 

Page size 8 1/2 x 11 

Margins 1/4 in. on all sides 

Font Courier 


Horizontal and vertical dpi (dots per inch) are used for selection 
of raster fonts. 


Environmental Setting: 


You can specify the following setting: 
Command Function 


SET PSINVERT=(on/off) “On” (default) prints black on k 
white, i.e., a chart with a white 
background will be printed with 
a black background. “Off” prints 
white on black. 


If the output is a blank picture, the driver creates no file. 
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QMS Printer 
Filename: QMS.sys 


Use the following SuperCalc command to access this driver: 
//Graphics,Global,Drivers,CGI,Printer,QMS Laser Printer 


Environmental Settings: 


You can specify the following setting: 


Command Function 
SET COPIES=(n) Specifies number of copies to 
print. 


Polaroid Palette Converter 
Filename: PALETTE.sys 


Use the following SuperCalc command to access this driver: 


//Graphics,Global,Drivers,CGI,Camera,Polaroid Palette 
Environmental Settings: 
You can specify the following settings: 
Command Function 


SET FILM=(film type) Specify film in use (supported 
films are listed below) 


SET EXP=(exposure number) Over- or under-exposes film 
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SET FILM 


Specifies a film type, which must be one of the following: 


Film Type Description 

669 Polaroid type 669 

AGFA Agfachrome ISO 100 

EKTA Ektachrome ISO 100 

FUJI Fujichrome ISO 100 

POLA Polaroid Polachrome 35 mm. 
SET EXP 


Specifies one of the following exposure numbers for darkening or 
lightening pictures: 


Exp Number F-Stop Effect 
1 (darker) -1 

2 -2/3 

3 -1/3 

4 (normal) 0 

° +1/3 

6 3 

7 (lighter) +1 
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Matrix QVP Language Converter 


For complete information about this driver, see the file 
MTXSCODL.doc on the Utility diskette. 


This driver outputs SCODL opcodes for Matrix QVP and MVP 
graphics processors. These processors output to several different 
devices, the most common of which are cameras. Because this 
driver does not know the type of output device, it does not 
support non-preserve aspect ratio mode. If you want this mode 
you must modify the QVP dimensioning. SCODL arcs, circles and 
text may not work as expected if the aspect ratio is not preserved. 


Filename: MTXSCODL.sys 


Use the following SuperCalc commands to access this driver: 
//Graphics,Global,Drivers,CGI,Camera,PCR 2K resolution 
//Graphics,Global,Drivers,CGI,Camera,PCR 4K resolution 
//Graphics,Global,Drivers,CGI,Camera,SCODL Camera 

Environmental Settings: 

You can specify many environmental variables that control the 

way this driver operates. For information, read the file 


MTXSCODL.doc on the Utility diskette that came in the 
SuperCalc package. 


QVP Processors (older version of MVP) 
Internal: QVPO 
External: QVP 


Change mode configuration bit to accept binary input (rather than 
ASCID. 


If you send output files to the QVP via the DOS COPY command, 
specify the binary type parameter. For example: 


COPY /b filename COMn 
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MVP Processors 


You must modify this driver in order for it to operate MVP 
processors. Do this by running the program the program 
MTX.exe, which is provided on the Utility diskette. 

QVP and MVP processors function the same way, so follow the 


procedures for QVP processors. 


VideoShow Presentation Graphics System 
Filename: VIDEOSHO.sys 


Use the following SuperCalc command to access this driver: 


//Graphics,Global,Drivers,CGI,Metafile, VideoShow 
Environmental Settings: 


You can specify the following setting: 


Command Function 
SET VSLIMIT= (n) Sets maximum output file size in 


bytes (default is 10000). 


SET VSLIMIT 


Sets the maximum number of bytes that can go into the output 
file. If you do not set VSLIMITS, 10K bytes (10000) is the default 
maximum number. 


You will know whether to set VSLIMITS by looking at your 
output. If your images display completely, then you need not set 
it. 


If your images display partially, then you need to set VSLIMITS. 


Try 50000. If the images still do not display, add another 1000, 
5000, or whatever, until they look right. 
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If your images do not display at all, then your file is too large or 
the code is too complicated for the amount of memory in your 
VideoShow device. To display your images, reduce the amount 
of code in the output file by removing some details from the 
picture. 


Hardware Fonts: 


The following table shows the font mapping for the VideoShow 
Presentation Graphics System. The first column lists the 
SuperCalc font and the second and third columns list the fonts 
that will appear on the screen and printer, respectively, when 
VideoShow is the selected device. 


SuperCalc Screen VideoShow 
Roman Roman Serif 
Helv Helv SanSerif 


The remainder of the fonts will appear as SuperCalc software 
characters on the VideoShow device. 


SuperImage 

Filename: SUPERIMG.sys 

The Superlmage 1.5 driver produces a file with the extension .sfd 
which you can import into Computer Associates Superlmage 
program for editing. Using Superlmage, you can add logos and 
other graphic symbols to your file. 

Use the following SuperCalc command to access this driver: 


//Graphics,Global,Drivers,CGI,Metafile,SuperImage 1.5 File 
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GEM File 
Filename: VENTURA.sys 


Use the following SuperCalc command to access this driver: 


//Graphics,Global,Drivers,CGI,Metafile, Ventura — 
Hardware Fonts: 


The following table shows the font mapping for the Ventura 
device. The first column lists the SuperCalc font and the second 
and third columns list the fonts that will appear on the screen and 
printer, respectively, when Ventura is the selected device. 


SuperCalc Screen Ventura 
Roman Roman GEM Font 1 
Helv Helv GEM Font 2 


The remainder of the fonts will appear as SuperCalc software 
characters on the Ventura device. 


Computer Associates Graphics Service 


See the flyer enclosed in your SuperCalc package for information 
on enrolling in and using the Computer Associates Graphics 
Service. 


Filename: CAGS.sys 


Use the following SuperCalc command to access this driver: 


//Graphics,Global,Drivers,CGI,Slide,CA Graphics Service 
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Hardware Fonts: 


The following table shows the font mapping for the Computer 
Associates Graphics Service. The first column lists the SuperCalc 
font and the second and third columns list the fonts that will 
appear on the screen and slide, respectively, when the slide 
service is the selected device. Note that the fonts that appear on 
the screen will be placed in the same positions as in slide output, 
even though the appearance of individual characters will be 
slightly different. 


SuperCalc Screen Graphics Service 
Stick Helv Helvetica 

Block Helv Helvetica 
BlockBold HelvBold HelveticaBold 
Roman Roman TimesRoman 
RomanBold RomanBold TimesBold 

Italic Italic Timesltalic 
ItalicBold ItalicBold TimesBoldItalic 
Script HelvItalic HelveticaOblique 
ScriptBold HelvBoldItalic HelvBoldOblique 
Gothic RomanBold TimesBold 
HelvLight Helv Helvetica 
HelvLightltalic HelvItalic HelveticaOblique 
Helv Helv Helvetica 


File Naming with Supported Drivers 


Files created with CGI drivers follow the specific conventions 
listed below. The drivers do not support DOS pathnames; they 
always write to the current directory. 


CGM Files 


Names may be any of eight alphanumeric characters with a forced 
extension of .cgm. 


You must change the name for each plot; files with duplicate 
names will be overwritten. 
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VideoShow Files 


Names may be any five alphanumeric characters with a forced 
extension of .pic. The name has an incrementing number added 
-to it. 


LaserGraphics Language Files 


This driver accepts your choice of an eight-character name and 
extension. You must change the name for each plot or they will 
overwrite. 


PostScript Files 


You can use any four alphanumeric characters with a forced 
extension of .ps. The name has an incrementing number added 
to it. 


SuperImage 1.5 Files 


Superlmage files have the forced filename DRAWxxxx.sfd. An — 
incrementing number is added between DRAW and the 
extension. 


Ventura Files 


You can use any four alphanumeric characters with a forced 
extension of .gem. The name has an incrementing number added 
to it. 


External CGI Metafiles 


You can’t enter a filename from within SuperCalc. You must use 
this DOS command: 


SET METAFIL= filename 
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CA Slide Service Files 


Computer Associates Slide Service files have the forced filename 
SLSVxxxx.slv. An incrementing number is added between SLSV 
and the extension. 


GSS/CGI device drivers are a proprietary software product of Graphics Software 
Systems, Inc., Beaverton, Oregon. LL.sys is a proprietary product of 
LaserGraphics, Inc., Irvine, California. 
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Index 


& function 3-39 
{ } macro commands 4-15 
@ function 3-39 
@ (symbol) 
using in headers/footers 2-145 
1-2-3 
command definition 2-172 
100%-Bar chart 2-232 
3COM 3+ networks 5-7 


A 


ABS function 3-40 
Absolute 
cell references 3-5 
named ranges 3-6 
Access names 5-7 
Accessing 
network resources 2-328 
ACOS function 3-40 
ACTIVATE program 5-4, 5-11 
Adapters 
IBM EGA card 1-31 
Add-in 
command definition 2-173 
remove from memory 2-175 
Adding 
blank columns 2-104 
blank rows 2-104 
consolidating spreadsheets 2-116 
ADDRESS function 3-41 
Adjusting 
and moving 2-122 
Alias 
spreadsheet nicknames 2-341 


Aligning data in cell 2-53 


Analysis of data 

Distribution 2-190 

Regression 2-191 
Analyzing 

commands available for E-1 
AND function 3-41 
ANDRATE function 3-41 
Annuities 

lifetime 3-28 

periodic 3-28 
ANTERM function 3-42 
Appearance 

commands for changing E-2 
Applications 

demonstration files I-1 
Area charts 2-238 

Chart Options Menu 2-284 

Simple-Area 2-238 

Stacked-Area 2-239 
Arguments 

functions 3-14 

macros 4-3 
Arithmetic 

operators 3-8 
Arithmetic functions 

examples 3-36 

summary of 3-20 
Arrange 

command definition 2-30 
Arranging 

database records 2-188 

examples 2-34 

order for sorting 2-33 
Ascending 

sort order 2-33 


Index 


ASCII 
creating a file 2-132 
entering in setup strings 1-27 
extended character set 2-90 
file macro I/O. 4-15 
importing file as text 2-298 
LICS translation 2-76 
ASIN function 3-42 
Asterisk (*) 
indicating hidden spreadsheets 
2-335 
ATAN function 3-43 
ATAN2 function 3-43 
Attaching | 
add-in programs 2-173 
Audit 
detail window B-33 
mode indicator 1-2 
printing reports 2-139 
using filters B-8 
verifying spreadsheets B-1 
Autostep mode 
tracing macros 2-311 
AVERAGE function 3-44 
Axis 
chart attribute options 2-268 
chart scaling options 2-260 
label options 2-251 


B 


Backing up 
saving files 2-160 
Backslash (\) 
entering decimal equivalents 1-27 
BALANCE function 3-44 
Banyan network 5-10 
Bar charts 2-229 
100%-Bar 2-232 
Chart Options Menu 2-270 
creating Bar/Line charts 2-271 
creating Grouped-Bar charts 2-270 
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Delta-Bar 2-233 
Grouped-Bar 2-231 
Simple-Bar 2-229 
Stacked-Bar 2-230 
BEGCOL function 3-45 
BEGROW function 3-45 
Bin range 2-190 
Blackjack 
demonstration files 1-3 
Blank 
command definition 2-36 
inserting line in report 2-137 
sending page to printer 2-137 
spaces indicating zeros 2-60 
Block 
generating data 2-196 
moving 2-121 
removing range 2-44 
Borders 
displaying column/row 2-101 
printing lines around ranges 2-149 
printing row/column headings 
2-144 
printing titles 2-143 
Boxes 
printing lines around ranges 2-149 
Breakpoint 
clearing 2-315 


placing in macro 2-313 


C 


Calculation (see also Recalculation) 
interruptible 2-73 
iteration control 2-90 
limiting range 2-98 
manual 2-90 
order in formulas 3-7 


order in spreadsheets 2-90 


a > 


Calendar functions 
examples 3-23 
special considerations for 3-25 
summary of 3-17 
Cancel 
clearing entry line 1-18 
using Undo 1-18 
CAPS keyboard mode 1-6 
CCOL 
See CURCOL function 3-45 
Cell 
absolute reference 3-5 
address in formulas 3-4 
assigning name to 2-125 
combining corresponding 2-115 
computed references 3-6 
duplicating contents of 2-38 
editing contents 2-47 
erasing contents of 2-36 
inserting 2-104 
locating contents of B-17 
protecting 2-156 
ranges in formulas 3-10 
relative reference 3-5 
removing protection on 2-167 
types B-17 
CGI 
settings 2-289, 2-290 
Changing appearance E-2 
CHAR function 3-45 
Chart Data and Options Menu 
numeric charts 2-245 
Word charts 2-249 
Chart Options Menu for 
Area charts 2-284 
Bar charts 2-270 
Dual charts 2-280 
Hi-Lo charts 2-285 
Line charts 2-283 
Pie charts 2-276 
Radar chart 2-287 
X-Y charts 2-286 


Chart types 
Area 2-238 
Bar 2-229 
Dual 2-235 
Hi-Lo 2-240 
Line 2-236 
Pie 2-234 
Radar 2-242 
Scatter plot 2-241 
Word 2-243 
X-Y 2-241 

Charts 
activating graphics 2-79 
Area chart options 2-284 
axis attribute options 2-268 
axis label options 2-251 
axis scaling options 2-260 
Bar chart options 2-270 
CGI settings 2-289 
colors list 2-295 
components of 2-220 
data label options 2-257 
defaults for printing 2-81 
deleting 2-293 
demonstration files 1-2 
disk file format 2-288 
drivers 2-289 
Dual chart options 2-281 
dual monitor 2-75, 2-79 
editing 2-292 
function keys 2-227 
Hi-Lo chart options 2-285 
legend options 2-254 
Line chart options 2-283 
linking 2-282 
loading 2-119, 2-292 
logarithmic scaling 2-262 
optimizing memory 1-30 
PIC file 2-289 
Pie chart options 2-276 
plotting/printing 2-294 


printer device selection 2-288 


Index 


Radar chart options 2-288 
saving 2-293 
see also Graphics 2-220 
specifying left or right Y-axis 2-248 
text range for—2-249 
ticks 2-262 
title options 2-258 
using numbers for options 2-226 
using spreadsheet references 2-225 
viewing On screen 2-228 
X-Y chart options 2-286 
CHOOSE function 3-46 
Circular reference 
controlling recalculation 2-92 
Circular references 
locating B-25 
Clearing 
current spreadsheet 2-114 
entry line 1-18 
multiple spreadsheets 2-335, 339 
split display screen 2-169 
Clock 
format for cell display 2-65 
CODE function 3-47 
Color 
displaying in 2-78 
for charting 2-295 
monitors 1-31 
COLS function 3-47 
Column 
adding blank 2-104 
removing 2-44 
controlling width 2-55 
hiding 2-56, 2-66 
inserting 2-104 
locking display 2-165 
moving 2-121 
option for hiding 2-50 
setting width 2-56 
transposing 2-38 
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Column headings 

displaying on screen 2-101 

printing 2-144 
Column-wise 

charting a range 2-246 

sorting 2-31 
Combining 

corresponding cells 2-115 
Comma 

separating thousands 2-59 
Command keys 1-7 
Commands 

in prior releases C-10 

line options 1-23 
Commodities 

demonstration files I-2 
Compaq computer 1-33 
Compatibility 

CSV 2-215 

dBase 

DIF 2-215 

DIF 2-215 E 

Lotus 1-2-3 

prior SuperCalc releases C-6 

XDIF 2-212 
COMPBAL function 3-48 
Configuration file 

keeping defaults 2-80 

loading graphics options 2-222 
Consolidation arithmetic 2-117 
Constants 

numeric 3-3 

string 3-4 
CONTENTS function 3-47 
Control transfer 

macro commands 4-7 
Controlling 

printed output 2-49 

screen display 2-49 nr 
Converting 

files from otner programs 2-297 

files to other programs 2-212 


Copies 
printing multiple reports 2-144 
Copy 
command definition 2-38 
Copying 
and transposing 2-41 
between spreadsheets 2-38 
cell contents to entry line 2-47 
chart to chart name 2-119 
extracting database records 2-186 
locating originals B-4 
special considerations for 2-42 
Copying files 
to network 5-13 
using DOS Copy 5-13 
Correction 
keys 1-17 
COS function 3-48 
COUNT function 3-48 
Creating 
keys 1-17 
new spreadsheet E-9 
blocks of data 2-196 
Criterion 
cell references 2-182 
field names 2-180 
formulas 2-182 
multiple conditions 2-181 
specifying any occurrence 2-180 
when to enter 2-179 
wild cards 2-181 
Criterion range 
adding or deleting fields 2-188 
in data management commands 
2-179 
multiple columns 2-182 
multiple rows 2-182 
CROW 
See CURROW function 3-49 
CSV file 
converting to SuperCalc 2-298 
exporting to 2-215 


CTERM function 3-49 
CURCOL function 3-50 
CURPAGE function 3-50 
Currency 

demonstration files 1-1 

displaying two digits 2-53 

string display 2-73 

symbol to display 2-58 
CURROW function 3-50 
CURSHEET function 3-50 
Cursor 

auto-advance feature 2-101 

limiting use of keys 2-333 

lockout option 2-102 

movement keys 1-13 

moving on the entry line 2-48 
Customizing (see also Defaults) 


display of cell contents 2-55 


D 


Data (see also Data management) 
command definition 2-176 
Data analysis 2-189 
Data directory 
changing 1-21 
Data entry demonstration file 1-3 
Data file 
search path for 2-217 
Data input 
macro commands 4-14 
Data labels 
Options Menu for charts 2-256 
Data management 
commands for 2-176 
deleting records 2-188 
demonstration file 1-3 
extracting data 2-186 
finding data 2-186 


functions used in data tables 2-209 


increasing spreadsheet size 2-189 


limiting to a range 2-333 


Index 


> 


moving 2-44 
regulating memory capacity 2-189 
selecting data 2-187 
sorting records 2-188 
summary of statistical functions 
3-19 
varying values with tables 2-207 
what-if projections 2-207 
Data management functions 
examples 3-33 
Data tables 
one value 2-205 
two value 2-206 
Data types 
list of basic 3-1 
Database demonstration files 1-3 
Datapath 
for file searching 1-22, 2-218 
saving with spreadsheet 2-219 
using DOS 2-219 
DATE function 3-50 
Date values 
in arithmetic context 3-24 
Date/Time 
data types 3-2 
functions 3-24 
Dates 
aligning 2-53 
formats for 2-55, 2-62 
generating blocks of 2-197 
loading as DVAL functions 2-115 
DATEVALUE function 3-51 
DAVG 
example with data table 2-209 
function 3-51 
DAY function 3-52 
DBase III file 
converting to SuperCalc 2-299 
DBaselll 
exporting to 2-215 
Dbf 


file extension 2-215 
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DCOUNT 
example with data table 2-209, 
2-210 
function 3-52 
DDB function 3-53 
Debugging 
macros 2-315 
Decade 
logarithmic chart scaling 2-264 
Decimals 
displayed as integers 2-54 
rounding 3-85 
Defaults 
chart attributes 2-222 
currency string 2-73 
data directory 2-216 
global 2-71 
memory 2-76 
next session 2-71 
Output device 2-88 
Output options menu 2-137 
printer setup string 1-25 == 
printing charts 2-81 
printing spreadsheets 2-85 
punctuation separators 2-72 
report page size 2-134 
resetting output options 2-147 
resetting with Zap 2-170 
restoring format 2-58 
viewing on screen 2-99 
Delete 
command definition 2-44 
Deleting 
clearing entry line 1-18 
database records 2-188 
protected cells 2-156 
range names 2-129 
ranges 2-44 
special considerations for 2-46 
Delta-Bar chart 2-233 
Demonstration files I-1 


Depreciation 3-30 


Descending 
sort order 2-34 
Destination range 
copying cells 2-39 
Detaching 
add-in programs 2-173 
Details 
viewing highlighted cells B-33 
Dialog panel 
macro commands 4-11 
DIF file 
converting to SuperCalc 2-297 
exporting spreadsheet to 2-215 
Directory 
File List 1-20 
linking to network 5-2 
network password protection 
5-2 
order searched 2-217 
unlinking from network 5-4 
Disk file 
loading spreadsheet 2-113 
importing other formats 2-296 
DISPLAY function 3-55 
Displaying 
currency in two digits 2-53 
in exponential format 2-53 
macro control of 4-10 
multiple spreadsheets 2-336 
numbers as integers 2-52 
positive integers 2-54 
rounded numbers 2-52 
splitting window 2-168 
using View modes B-30 
viewing data 2-599 
Distribution analysis 2-190 
Dividing 
arithmetic operators 3-8 
consolidating spreadsheets 2-117 
Divisions in charts 
logarithmic scaling 2-264 


normal scaling 2-263 


DMAX function 3-55 
DMIN function 3-56 
DOS 
using SET DATAPATH= 2-219 
Double-spacing reports 2-142 
DSTD function 3-56 
DSUM function 3-57 
Dual charts 2-235 
Chart Options Menu 2-280 
linking 2-282 
Duplicating 
cell contents 2-38 
DVAL function 3-57 
DVAR function 3-57 


E 


ECOL 
See ENDCOL 3-58 
EDAT function 3-58 
Edit 
command definition 2-47 
mode indicator 1-2 
Editing 
cell contents 2-47 
protected cells 2-47 
using cursor keys 1-16 
END keyboard mode 1-7 
ENDCOL function 3-59 
ENDROW function 3-59 
Entering data 
demonstration file 1-3 
for chart options 2-224 
Entry line 
moving cursor 2-48 
toggle between label/range 2-130 
ENTRY mode 1-2 
Erasing 
cell contents 2-36, 2-170 


clearing entry line 1-18 


Index 


data E-3 


spreadsheet from memory 2-157, 


2-170 

Error 

data type 3-2 

locating spreadsheet 

inaccuracies B-1 

ERROR function 3-59 
Evaluation (see Calculation) 
EXACT function 3-59 
Executing 

Lotus commands 2-172 
Exiting 

from SuperCalc 2-157 
EXP function 3-60 
Expanded 

memory board 1-33 
Exponential 

displaying numbers 2-53 
Export 

command definition 2-212 
Exporting 

to CSV format 2-215 

to dBase III format 2-215 

to DIF format 2-215 

to XDIF format 2-212 
Extracting data 2-186 


limiting number of records 2-185 


order of fields 2-185 


F 


FALSE function 3-60 
Fast 
optimizing speed 1-28 
Features 
in SuperCalc 1-1 
summary of new C-1 
Fields 
for parsing data 2-201 


in an input range 2-179 
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in an Output range 2-185 
matching 2-180 
File 
automatic searching for 1-19 
.bak extension 2-160 
.prn extension 2-134 
combining 2-118 
command definition 2-216 
copying to network 5-13 
creating ASCII 2-134 
default extension 2-75 
graphics formatted 2-289 
locating a 2-217 
locking network 5-2 
network access to 5-7 
servers on network 2-328 
specifying extension 1-21 
spreadsheet operations 2-334 
viewing details of 1-21 
File control macro commands 4-15 
File List 
data directory for 2-217 
introduction 1-19 
limiting file extensions 2-217 
File macro (see also Macro) 
invoking 4-8 
FILE mode 1-3 
Filters 
using in Audit B-8 
Financial functions 
annuities 3-28 
demonstration files 1-1 
depreciation 3-30 
examples 3-26 
investing each period 3-29 
onetime investments 3-29 
summary of 3-17 
table of terms 3-27 
FIND function 3-60 
Finding 
cell contents B-17 
data 2-186 


Fnmax file 1-2 
Fnplot file 1-2 


Fonts assigning add-in programs to 


Frequency distribution 2-190 


Function keys 


applying and removing 2-148 2-174 


cartridges 2-86 graphics 2-227 


defining 2-87 - list of 1-7 
locating cells assigned B-24 macro 2-305 
softfonts 2-86 Functions 


Footers arguments 3-14 
arithmetic 3-36 
calendar 3-23 


chart demonstration file 1-2 


creating 2-145 

printing 2-138 

setup strings in 1-26 
Foreign data management 3-33 


currency symbols 2-57 examples of usage 3-21 


Format financial 3-26 
command definition 2-49 index 3-31 
FORMAT function 3-61 list of 3-16 


logical 3-22 
special purpose 3-39 


Format lines 2-202 


Formatting 


charts 2-252 

default 2-55 

defining date and time 2-61 

levels of hierarchy 2-51 

removing 2-55 

saving menu settings 2-57 

saving spreadsheets in other 2-212 
sets 2-57 

user-defined 2-56 


viewing settings 2-51 


Formulas 


adjustment 3-11 

copying to new location 2-40 
definition of 3-3 
displaying in cells 2-99 
entry mode 2-100 
evaluation order in 3-7 
invariant 3-11 

locating relationships B-25 
recalculating as sorted 2-34 
simultaneous 2-92 

viewing in detail B-5 


viewing patterns in B-4 


statistical 3-32 

string 3-37 

trigonometric 3-36 
FV function 3-62 


G 


Games demonstration files I-3 
Generating data 
dates 2-197 
numbers 2-197 
times 2-197 
Global 
chart device settings 2-288 
command definition 2-67 
Options Menu for charts 2-290 
Graphics 
adapter cards 1-31 
basic operations 2-222 
defaults for printing 2-81 
dual monitor 2-79 
enabling 2-220 
exiting 2-294 


Index 


function keys 2-227 
making field entries 2-224 
menus 2-224 
optimizing memory 1-30 
saving chart defaults 2-222 
see also charts 2-220 
Grid lines 
printing reports with 2-150 
Grids 
chart axis 2-222 
Grouped-Bar chart 2-231 
Growth 


demonstration files 1-2 


H 


Hardware 

considerations for 1-31 
Headers 

creating 2-145 

printing 2-138 

setup strings in 1-26 
Hercules Graphics card 1-33 
Hewlett Packard 

LaserJet printer 1-33 
Hi-Lo chart 2-240 

Chart Options Menu 2-285 
Hiding 

and redisplaying 2-55 

column 2-66 

columns 2-50 

spreadsheet pages 2-338 

spreadsheets 2-335 
Hierarchy 

of format levels 2-51 
Highlight 

detail window B-33 

locating cells B-16 

printing reports 2-139 

recalculated cells B-23 

using filters B-8, B-16 
HLOOKUP function 3-63 
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HOUR function 3-64 


I 


IBM PC networks 5-8 
IF function 3-65 
IF-AND combinations function 3-66 
IF-OR combinations function 3-67 
Import 
command definition 2-296 
Importing 
and consolidation 2-301 
partial files 2-301 
Increments 
normal scaling 2-263 
INDEX function 3-67 
Index functions 
examples 3-31 
macro commands 4-4 
summary of 3-18 
Initialization string 
for printer control 2-146 Ae 
Input cells 2-205, 2-206 
INPUT mode 1-3 
Input range 
adding or deleting records 2-188 
data management commands 
2-178 
distribution analysis 2-190 
omitting field names 2-179 
parsing data 2-204 
Insert 
command definition 2-104 
Inserting 
new page(s) 2-104 
ranges 2-104 
special considerations 2-105 
Installation 
network 5-6 
INT function 3-68 
Integers 


displaying positive 2-54 


Invariant 

formulas 3-11 
Investing each period 3-29 
Invisible 

hiding columns 2-56 
Invoking 

add-in programs 2-173 
IRR function 3-68 
ISBLANK function 3-69 
ISDATE function 3-69 
ISERROR function 3-70 
ISNA function 3-70 
ISNUM function 3-70 
ISPROT function 3-70 
ISSTR function 3-70 
ISTIME function 3-71 
ISVAL function 3-71 
ITER function 3-71 
Iteration 

demonstration files I-2 


Iteration control 2-90 


J 


JDATE function 3-71 
JTIME function 3-72 
Justify 
command description 2-106 
Justifying 
text 2-106 
with word-wrap 2-111 


K 


Keeping 
chart defaults 2-222 
default directory 1-21 
saving charts 2-222 
saving defaults 2-80 
Key column 


entering 2-32 


Key row 
entering 2-33 
Keyboard macro commands 4-8 
Keys 
list of function 1-7 
KINT function 3-72 
KPRIN function 3-72 


L 


Labels 
chart 2-221, 2-251 
extracting names from 2-127 
range name in cells 2-100 
LASTCOL function 3-72 
LASTROW function 3-73 
LCOL 
See LASTCOL function 3-73 
Learn mode 2-306 
LEFT function 3-73 
Legends 
chart options menu 2-254 
LENGTH function 3-73 
Limiting 
data input to range 2-333 
Line charts 2-236 
Chart Options Menu 2-283 
Simple-Line 2-236 
Stacked-Line 2-237 
Line feed 2-137, 2-143 
Lines 
control text for printing 2-151, 
2-153 
printing grids 2-150 
printing horizontal 2-150 
printing range borders 2-149 
printing vertical 2-152 
Linked Network Directories 
displaying screen of 2-328 


Index 


11 


Linking 
Dual charts 2-282 
network file directories 5-1 
spreadsheets 2-335 
Links 
locating in cells B-23 
LN function 3-73 
Load 
charts 2-292 
command definition 2-113 
opening blank spreadsheet 2-338 
Loading 
and difference of cells 2-116 
. and product of cells 2-116 
and quotient of cells 2-117 
and summing cells 2-116 
calculated values only 2-115 
chart descriptor 2-119 
files at startup 1-23 
files from other programs 2-296 
multiple spreadsheets 2-335 
named ranges 2-113, 2-118 
page from another spreadsheet 
2-119 
partial spreadsheet 2-115 
special considerations 2-120 
spreadsheet 2-113 
SuperCalc4 charts 2-119 
Loan demonstration files I-2 
Local area network 
network administrator 5-4 
Locating 
a file 2-217 
Locking 
column/row display 2-165 
files 5-2 
network files 2-328 
titles on split-screen 2-168 
LOG10 function 3-74 
Logarithmic scaling 
charts 2-262 
examples 2-265 
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Logic macro commands 4-13 
Logical functions 
examples 3-22 
summary of 3-16 
LOOKUP function 3-74 
Lotus 1-2-3 
character set 2-76 
compatibility with SuperCalc 
D-1 
default extension 2-75 
issuing commands 2-172 
macros 2-322 
saving spreadsheet to 2-159 
using with SuperCalc 2-598 
Lotus Compatibility mode 
executing commands in 2-172 
LOWER function 3-75 
LROW 
See LASTROW function 3-75 
LU function 3-75 


M 


Macro 

analyzing structure of 2-315 

arguments 4-3 

breakpoints 2-313 

building file 2-326 

capturing keystrokes 2-306 

command definition 2-304 

command syntax 4-1 

compatibility with prior 
versions C-11 

conditional statements 4-37 

control transfer 4-7 

converting 1-2-3 macros 2-322 

creating in ASCII 2-309 

current spreadsheet 4-6 

data input commands 4-14 

debugging 2-311, 2-313, 2-315 

demonstration files 1-3 


dialog panel 4-11 


executable characters 4-2 Select command 2-187 


eXecute file 2-309 Unique command 2-186 

eXecute invoking 2-310 Math coprocessor 1-32 

execution control 4-13 Matrix 

file-control 4-15 demonstration file 1-3 

function keys 2-305 Matrix operations 2-198 

index functions 4-4 MAX function 3-75 

invoking 4-7 Memory 

keyboard commands 4-8 default data-space 2-76 

keyboard control 4-14 deflate data space 2-77 

learn mode 2-306 expanded 2-77 

logic commands 4-13 expanding 1-31 

macro spreadsheet 4-6 optimizing 1-28 

mode indicators 1-5 removing add-in programs from 

modes 2-305 2-175 

Named Range Directory 4-7 saving 1-30 

naming file 2-327 using 2-79 

naming spreadsheet 2-325 using Squeeze to reduce B-30 

programming commands 4-10 Memory board 

prompts 1-6 using expanded 1-33 

read a file into range 2-308 MENU mode 1-3 

saving or loading spreadsheet MID function 3-75 

2-326 MIN function 3-76 

saving to file 2-309 MINUTE function 3-76 

screen control commands 4-10 MOD function 3-77 

special considerations 2-325 Mode 

splitting statements 4-5 axis scaling 2-262 

string 4-3 indicators 1-1 

tracing 2-311 pie 2-276 

using with multiple Modems 2-88 

spreadsheets 4-6 Modes 

Zap restrictions 2-308 macro 2-305 
Manual Monitor 

axis scaling type 2-261 color 1-31 

recalculation 2-90 dual 1-32, 2-75, 2-79 
Margins expanded screen 2-103 

for printing reports 2-141 flashing problems with 2-75 
Matching records LCD 1-32 

criterion for 2-179 monochrome 2-79, 1-33 

Extract command 2-186 selecting default 2-78 

Find command 2-186 settings for graphics 2-290 


none found 2-185 


Index 13 


Monochrome 


monitor 1-33 


MONTH function 3-78 


Move 


command description 2-121 


Moving 


2-121 
and transposing 2-122 


a range 


between spreadsheet windows 
2-336 
data 2-44 


special considerations 2-123 


Multi-level sorting 2-31 


Multipage spreadsheet 


saving single page 2-163 


Multiple 


pages and spreadsheets 2-342 


Multiple spreadsheet 


displaying the next 2-157 


macro execution 4-6 


Multiplying 


N 


arithmetic operators 3-8 


consolidating spreadsheets 2-116 


N function 3-78 


N/A 


data type 3-2 


NA function 3-78 


Name 


command definition 2-125 


NAME mode 1-3 
Named Range Directory 2-129 


Named ranges 
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displaying in cells 2-100 

loading 2-113, 2-118 

locating possible errors B-3, B-27 
removing names 2-126 

using 2-129 


using in formulas 3-5 
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Naming 
a range 2-125 
from Named Range Directory 
2-128 
several ranges 2-127 
special considerations for 2-131 
Negative values 
absolute function 3-40 
format for displaying 2-59 
Network 
access names 5-7 
ACTIVATE program 5-11 
adding users 5-6, B-17 
command definition 2-328 
copying SuperCalc files to 5-13 
decreasing users 5-19 
maintenance 5-16 
protecting files 2-330 
special considerations for 2-331 
status 5-23 
updating SuperCalc versions 5-20 
using Activate 5-4 
using SuperCalc on 5-1 
Networks 
3COM 3+ 5-7 
Banyan 5-10 
IBM PC 5-8 
Novell 5-9 
STARLAN 5-10 
Normal scaling 
charts 2-262 
NOT function 3-78 
Novell networks 5-9 
NOW function 3-79 
NPV function 3-79 
NUM keyboard mode 1-6 
Numbers 
aligning 2-53 
displaying as integers 2-52 
formats for 2-55 


generating blocks of 2-197 


larger than column width 2-53 
thousands separators 2-59 
Numeric 
constants 3-3 
data type 3-2 
Numeric file 


converting to SuperCalc 2-298 


O 


Onetime investments 3-29 
Open 
blank spreadsheet 2-338 
displaying Spreadsheet 
Directory 2-335 
multiple windows 2-336 
Open Spreadsheet Directory 
using 2-337 
Open spreadsheets 
concept of 2-334 
Operand 
separator symbols 2-58 
definition of 3-3 
Operating system 
exiting to 2-157 
Operators 
arithmetic 3-8 
relational 3-9 
string 3-10 
Optimizing 
SuperCalc performance 1-28 
OR function 3-80 
Order of data E-2 
Orientation 
of printed report 2-141 
using SIDEWAYS 2-132, H-1 
Output 
command definition 2-132 
device defaults 2-88 
disk file 2-134 
displaying on screen 2-136 
double-spacing reports 2-142 
locating attributes B-23 


multiple ranges 2-136, 2-142 

plotting charts 2-294 

printer settings 2-85 

printing reports 2-132 

selecting network device 5-4 

setting cell formats 2-49 

split-screen 2-168 

titles 2-166 

with SIDEWAYS 2-H-1 
Output Options Menu 2-137 
Output range 

adding or deleting fields 2-188 

creating ASCII files 2-136 

data management commands 

2-185 
parsing data 2-204 
printing reports 2-136 


regression analysis 2-192 


P 


Page feed 
placing in spreadsheet 2-154 
sending to printer 2-137 
Pages 
hiding 2-338 
inserting new 2-104 
loading from another 
spreadsheet 2-119 
ranges in formulas 3-10 
renumbering of remaining 2-45 
saving single 2-163 
size for printed reports 2-140 
specifying in multiple 
spreadsheets 2-341 
PAIDINT function 3-80 
Parsing 
demonstration file 1-3 
imported files 2-303 
method for 2-201 


Index 
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Passwords 

network access names 2-329, 

5-7 

to network directory 5-2 
Path 

for file searching 2-217 
Performance 

optimizing SuperCalc 1-28 
PI function 3-81 
PIC file 2-289 
Pie charts 

Chart Options Menu 2-276 

examples 2-234 

pie explosion 2-248 
Plotting 

CGI option 2-289 

charts 2-294 

device settings 2-290 
PMT function 3-81 
POINT mode 1-4 
Pointing 

in multiple spreadsheets 2-340 
Ports 

network assignment 5-4 
Positive integers 

displayed as asterisk 2-54 
Preventing 

changes to cell 2-156 
Previewing reports 2-136 
Printer 

CGI option 2-289 

default setup string 1-25 

graphics device 2-82, 2-288 

graphics settings 2-290 

HP LaserJet 1-33 

initialization string 2-146 

interface settings 2-89 

setup string 2-146 

spreadsheet device 2-86 
Printing (see also Output) 

charts 2-294 

spreadsheets 2-132 
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Programming macro commands 4-10 
Programs 

converting files from other 2-297 

sending files to other 2-598 
PROPER function 3-82 
Protect 

command definition 2-156 
Protected cells 

editing 2-47 

entire spreadsheet 2-102 

saving only 2-162 

toggle on/off 2-101 
Protecting 

cell from changes 2-156 

hiding columns 2-56 

locking files 5-2 
PV function 3-82 


Q 


Quit 


command definition 2-157 UL 


multiple spreadsheets 2-157 
temporarily 2-157 

to another program 2-157 
to Operating system 2-157 


R 


Radar charts 2-242 

Chart Options Menu 2-287 

XYXY chart 2-288 

XYY chart 2-288 
RANDOM function 3-83 
Ranges 

copying 2-38 

data label 2-256 

erasing cell contents of 2-36 

for printing 2-136 

in formulas 3-10 

input 2-190 


legend label 2-254 


manual label, axis scaling 2-262 


naming 2-125 
series for charting data 2-245 
specifying in multiple 
spreadsheets 2-340 
word data 2-249 
X-axis label 2-251 
RATE function 3-84 
Reading (see also Loading) 
files 2-113 
READY mode 1-4 
Recalculation (see also Calculation) 
options for 1-29 
highlighting cells effected B-23 
sorted formulas 2-34 
Records 
deleting 2-188 
matching criterion 2-179 
Reference 
absolute cell 3-5 
function 3-7 
relative cell 3-5 
syntax 2-39 
Regression 
analysis 2-191 
coefficients 2-195 
Relational 
operators 3-9 
Relative 
cell references 3-5 
Remain command 
positioning cursor 2-187 
Removing 
add-in programs 2-175 
cell protection 2-167 
column range 2-44 
format options 2-55 
page(s) from spreadsheet 2-45 
row range 2-44 
title locking 2-166 


using Blank 2-36 
using Undo 1-18 
REPEAT function 3-84 
REPLACE function 3-84 
Replacing cell contents B-28 
Report (see also Output) 
disk file 2-134 
displaying on screen 2-136 
printing 2-132 
Restrict 
command definition 2-333 
Restricting 
cursor lockout 2-102 
network access E-7 
searching of datapath 2-218 
Retrieving 
loading SuperCalc files 2-113 
Lotus 1-2-3 files D-2 
other files 2-296 
RIGHT function 3-85 
ROUND function 3-85 
Rounding 
numbers 2-52 
ROUNDUP function 3-85 
Row headings 
displaying on screen 2-101 
printing 2-144 
Row-wise 
charting a range 2-246 
sorting 2-31 
Rows 
inserting blank 2-104 
locking display 2-165 
moving 2-121 
removing 2-44 
transposing 2-38 
ROWS function 3-86 
Run 


demonstration file 1-3 


Index 


T 


S 


S function 3-86 
Samples files 
described I-1 
Save 
command definition 2-159 
Saving 
chart defaults 2-222 
charts 2-293 
format menu settings 2-57 
format settings 2-61 
in other formats 2-212 
keeping defaults 2-80 
memory 1-30 
multiple spreadsheets 2-335, 
2-338 


part of the spreadsheet 2-161 
single spreadsheet page 2-163 


special considerations 2-164 
to diskfile 2-159 
to earlier versions 2-161 


user-define formats 2-66 


values as numeric constants 2-161 


Scaling 
specifying 2-60 
Scatter Plot charts 2-241 
Scientific applications 
demonstration files I-2 
Screen (see also Monitor) 
displaying report 2-136 
flashing problem 2-75 
LCD 1-32 
monochrome 2-79, 1-33 
selecting monitor 2-78 
standard or expanded 2-103 


using View modes B-30 


Screen control macro commands 4-10 


SCROLL keyboard mode 1-6 
Scrolling 

windows 2-169 
Searching 


and replacing B-28 
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data path during loading 2-217 


locating cell contents B-17 
SECOND function 3-86 
Selecting data 2-187 
Selection field 2-225 
Separating 

strings into fields 2-303 
Series 

chart 2-222 
Setup string 

characteristics of 1-27 

for printer control 2-146 

in macro LEARN mode 1-27 

using 1-25 
Shading 

printing ranges with 2-150 
Sharenames on network 5-7 
Sharing 

network resources 2-328 
SHEET mode 1-4 
Shortnames on network 5-7 
SIDEWAYS 

creating file for 2-134 

guidelines for using 2-H-1 

report orientation 2-141 
Simple-Area chart 2-238 
Simple-Bar chart 2-229 
Simple-Line chart 2-236 
Simpson 

demonstration files 1-2 
SIN function 3-87 
SLN function 3-88 
Sort key 

clearing existing 2-32 
Sorting 

adjusting formulas 2-34 

column-wise 2-32 

database records 2-188 

examples of 2-34 

order of 2-33 


row-wise 2-32 


Source cell 

copying contents to entry line 

2-47 

Source range 

copying cells 2-39 
Spacing 

in printed reports 2-142 
Special-purpose functions 

examples 3-39 

summary of 3-21 
Speed 

optimizing 1-28 
Splitting 

display window 2-168 
Spreadsheet 


cells combined with disk file 2-115 


clearing all open 2-339 
combining 2-118 
displaying multiple 2-336 
hiding 2-338 
linking 2-335 
list of in memory 2-335 
loading 2-113 
nicknaming 2-341 
opening blank 2-338 
printing of wide 2-H-1 
removing pages from 2-45 
resetting default settings 2-170 
saving to diskfile 2-159 
size 2-77 
zapping page of multipage 2-171 
Spreadsheet macro 
invoking 4-7 
Spreadsheets 
command description 2-334 
special considerations 2-340 
SORT function 3-88 
Squeezing formulas B-30 
Stacked-Area chart 2-239 
Stacked-Bar chart 2-230 
Stacked-Line chart 2-237 
STARLAN networks 5-10 


Starting up 

options at command line 1-23 
Statistical functions 

examples 3-32 

summary of 3-19 

demonstration files 1-2 
Status line 

printing on reports 2-138 
STD function 3-89 
Step mode 

tracing macros 2-311 
String 

constants 3-4 

data type 3-2 

macro arguments 4-3 

operators 3-10 
STRING function 3-90 
String functions 

examples 3-37 

summary of 3-20 
Strings 

separating into fields 2-303 
Subtracting 

arithmetic operators 3-8 

consolidating spreadsheets 2-116 
SUM function 3-90 
SuperCalc 

compatibility with prior releases 

C-6 

copying files to network 5-13 

exiting from 2-157 

features in 1-1 

hidden options C-10 

list of modes in 1-1 

new features C-1 

sample files 1-1 

updating version on network 

5-20 

using earlier versions 2-161 
SYD function 3-90 
Synchronizing 

split display 2-169 


Index 
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Syntax 
in functions 3-14 


macro commands 4-1 


T 


Tab 
skipping designated cells 2-102 
TAB keyboard mode 1-7 
Table demonstration files 1-1, 123 
Tables 
active 2-207 
one value 2-205 
recalculating 2-207 
two value 2-206 
with databases 2-207 
TAN function 3-92 
TAVL function 3-95 
TCOL 
See THISCOL function 3-92 
TERM function 3-92 
Test (see also Audit) 
command definition B-1 
Text 
entering with quotation mark 
2-100 
entering with word-wrap 2-111 
format position of 2-54 
justifying 2-106 
wrapping rows 2-106 
Textual values C-11 
THISCOL function 3-93 
THISROW function 3-93 
Thousands 
separators in numbers 2-59 
Ticks 
chart 2-222,°2-262 
TIME function 3-93 
Times 
aligning 2-53 
formats for 2-55 


generating blocks of 2-197 
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loading as TVAL functions 2-115 
selecting format 2-62 
set to 24-hour 2-73 
TIMEVALUE function 3-93 
Title 
command definition 2-165 
Titles 
chart components 2-220 
chart options for 2-258 
locking on split-screen 2-168 
printing in reports 2-143 
printing of 2-166 
TODAY function 3-94 
Tokens 
in format strings 2-62 
Trace 
checking macro execution 2-311 
Transposing 
and copying 2-41 
Trigonometric functions 
examples 3-36 
summary of 3-20 
TRIM function 3-94 
TROW 
See THISROW function 3-94 
TRUE function 3-94 
TRUNC function 3-95 
TYPE function 3-95 
Typing 
continuously using Word-wrap 
2-111 


U 


Undo 

activating 2-74 

clearing entry line 1-18 
Unique 

data management command 2-186 
Unprotect 


command definition 2-167 


Updating 
compatibility C-6 
SuperCalc on network 5-20 
UPPER function 3-96 
User-defined 
Date Format Menu 2-61 
options for formatting 2-50 
resetting formats 2-66 
saving formats 2-66 
Users 
adding network 5-17 


decreasing on network 5-19 
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VALUE function 3-96 
Values 
varying in tables 2-205 
VAR function 3-96 
Verifying spreadsheets B-1 
Vertical bar 
control text for lines 2-151, 2-153 
format lines 2-202 
headers/footers 2-145 
page break 2-154 
restricting datapath search 2-218 
View mode 
looking for patterns B-4, B-30 
printing reports 2-139 
special characters for B-31 
Viewing 
file details 1-21 
format settings 2-51 
hidden columns 2-56 
VisiCalc file 
converting to SuperCalc 2-298 
VLOOKUP function 3-97 
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WDAY function 3-98 
What-if analysis 

data tables 2-205 
Width 

controlling column 2-55 

of output range 2-147 

of printed reports 2-140 
WIDTH function 3-99 
Wildcard 

in criterion range 2-181 
Window 

command description 2-168 
Windows 

moving between 2-336 
Wine 

demonstration files 1-3 
Word charts 

data range 2-249 

options 2-249 
Word processor 

editing a file 2-132 
Word-wrap 

using WRAP mode 2-111 
WRAP mode 1-5 

using for Word-wrap 2-111 
Wrapping 

rows of text 2-106 
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X-Y charts 
Chart Options Menu 2-286 
XYXY chart 2-241, 2-287 
XYY chart 2-241, 2-287 
XDIF file 
converting to SuperCalc 2-297 
XDIF format 
converting spreadsheet to 2-212 
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XYXY chart 
Radar chart 2-288 
X-Y chart 2-287, 2-241 
XYY chart 
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Y-axis 
specifying left or right 2-248 
YEAR function 3-99 
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Zap 

command definition 2-170 
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multiple spreadsheets 2-339 

page of multipage spreadsheet 

2-171 

special considerations for 2-171 

Zeros 


appearing as blank space 2-60 
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